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Preface 



This publication is intended to help you 
use the debugging facilities provided with 
the IBM System/ 360 Operating System. It 
describes,, in assembler language terms, the 
major debugging facilities provided with 
the System/360 Operating System, and is 
directed towards the programmer who deals 
with system and application program 
problems. 



The publication is divided into three 
principal parts: "Section 1: Operating 
System Concepts;" "Section 2: Interpreting 
Dumps;" and "Section 3: Tracing Aids," 
plus an Introduction and a set of 
Appendixes that provide specific debugging 
information. 



The Introduction provides a brief survey 
of the material presented in the balance of 
the publication. 



Section 1 deals with internal aspects of 
the operating system that are pertinent to 
debugging. A working knowledge of this 
information will provide you with the means 
of determining the status of the system at 
the time of failure, and the course of 
events which led up to that failure* The 
general precedure for debugging with an 
operating system dump (Appendix A) assumes 
knowledge of this control flow. 



Section 2 includes instructions for 
invoking, reading, and interpreting storage 
dumps of systems with MFT or MVT control 
programs. The material is intended to aid 
you in interpreting dumps and isolating 
errors . 

Section 3 deals with the save area 
chain, the Trace Option, and the 
Generalized Trace Facility. Output from 
the Generalized Trace Facility is 
discussed. 

Before reading this publication, you 
should have a general knowledge of 
operating system features and concepts as 
presented in the prerequisite publications. 
Occasionally, the text refers you to other 
publications for detailed discussions 
beyond the scope of this book. 



For information on debugging facilities 
provided within higher languages, consult 
the programmers' guides associated with the 
respective languages. Other System/ 3 60 
Operating System publications, such as 
Messages and Codes , describe additional 
debugging aids provided for the assembler 
language programmer. 

Notice : Coding level information presented 
in this publication must not be used for 
coding purposes or exposure to changes in 
implementation may result. The information 
is presented for debugging purposes only. 
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Summary of Amendments 

for GC28-6670-5 

OS Release 21 



PCP REMOVAL 



References to the PCP version of 
Operating System/360 have been deleted 
from the publication. 



TESTRAN REMOVAL 

References to the TESTRAN testing 
facility of Operating System/360 have 
been deleted from the publication. 



IMDPRDMP SERVICE AID OUTPUT 

Storage dumps as formatted and 
displayed by the IMDPRDMP service aid 
are now discussed in this publication. 
This material was formerly in the 
Service Aids publication, GC28-6719. 



GENERALIZED TRACE FACILITY (GTF) OUTPUT 

GTF trace records, as processed by the 
EDIT function of the IMDPRDMP service 
aid are illustrated and discussed in 
Section 3 of the publication. 



DEVICE SUPPORT 



The sense byte information given in 
Appendix G is updated to include 
information for the: 

IBM 3420 Magnetic Tape Unit and 3803 
Tape Control 



IBM 2596 Card Read Punch 

IBM 3505 Card Reader 

IBM 3525 Card Punch 

IBM 3410 Magnetic Tape Unit 

IBM 3411 Magnetic Tape Unit and 

Control 



PROBLEM DETERMINATION 



Addition of an Appendix discussing 
problem determination aids for 
OPEN/CLOSE/EOV processing. 



Updating of the completion codes and 
service aids Appendixes to reflect 
release 21 changes. 



The Console Dump facility, used to 
obtain a storage dump for later 
processing by IMDPRDMP, is briefly 
described in the storage dump and 
IMDPRDMP formatting section of the 
publication. 



MISCELLANEOUS 

Editorial improvements and corrections 
to existing material have been made 
throughout the publication. 
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Summary of Amendments 

for GC28-6670-4 

as Updated by GN28-2457 and GN28-2472 

OS Release 20.1 



TCAM 



Section 2: ABEND/SNAP Dump (PCP and MFT) 
ABEND/SNAP Dump (MVT) 
Appendix A 
Appendix H 

A brief description of TCAM debugging 

Aids and a new SVC. 



3330. 2305. 2319 

Appendix F 

Additional of sense byte information fo 
new devices. 



TSO 



MISCELLANEOUS 



Section 2: TSO Control Blocks 

Appendix A 

The addition of new SVCs and a summary 
of the control blocks formatted by 
IMDPRDMP.. 



Appendix C 

1. Addition of module name prefixes 
for emulator programs. 

Appendix G 

2. New features of service aid program 
IMAPTFLE. 



Summary of Amendments 
for GC28-6670-3 
OS Release 20 



IMDPRDMP 



TSO 



'Guide to Using a Storage Image Dump" 
IMDPRDMP is used instead of IEAPRINT to 
print MFT and MVT dumps. 



Appendix A 

New SVCs in Appendix A. This 
information is for planning purposes 
only. 
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Introduction 



To debug efficiently, you should be 
familiar with the system control 
information reflected in dumps. This 
control information, in the form of control 
blocks and traces, tells you what has 
happened up to the point of error and where 
key information related to the program is 
located. To provide an insight into the 
IBM System/36,0 Operating System and its 
complex aspects of task management and 
storage supervision. Section 1 of this 
publication provides an orientation in the 
control functions of the operating system. 

The IBM System/ 360 Operating System 
provides extensive debugging facilities to 
aid you in locating errors and determining 
the system state quickly. Some debugging 
aids, such as console messages, provide 
limited information that may not always 
help you identify the error, This manual 
discusses those debugging facilities that 
provide you with the most extensive 
information: 

a. Abnormal termination (ABEND) and 
snapshot (SNAP) dumps. 

b. Indicative dumps. 

c. Storage image dumps. 

d. Tracing facilities. 

Dumps are discussed in Section 2 and 
tracing facilities in Section 3. 

ABEND and SNAP Dumps are invoked by ABEND 
and SNAP macro instructions, respectively. 
They are grouped in a single category 
because they provide identical information. 
In addition to a hexadecimal dump of main 
storage, they can contain conveniently 
edited control information and displays of 
the operating system nucleus and trace 
table. 

Indicative dumps contain control 
information useful in isolating the 
instruction that caused an abnormal end of 
task situation. The information is similar 
to that given in an ABEND/SNAP dump, but 
does not include a dump of main storage. 

Storage dumps are produced by either the 
system dump facility at the time of a 
system failure, or by a dump program 
created through use of the IMDSADMP service 
aid. IMDSADMP programs must be loaded into 



storage through use of the IPL facilities 
and are intended for use in situations in 
which the system is not operative, e.g., a 
disabled wait state or an unending system 
loop. 

The system dump facility writes to the 
SYS1.DUMP data set. The IMDPRDMP service 
aid is used to format and print the 
SYS1.DUMP data set. IMDPRDMP output is 
described in this publication. The 
IMDSADMP programs write to tape (high-speed 
dump) or to tape or printer (low- speed 
dump) . The output tape produced by the 
high-speed dump must be processed by the 
IMDPRDMP program; low-speed output to tape 
may be processed by IMDPRDMP, IEBPTPCH or 
the IEBGENER utility program. 

Storage dumps taken by the system dump 
facility consist of control information 
followed by a display of printable storage 
from location 00 to the capacity of 
storage. Storage words are displayed in 
both hexadecimal and EBCDIC notation. 
Storage dumps taken by an IMDSADMP program 
consist of register contents followed by a 
display of storage from location 00 to the 
capacity of storage. Notation is in both 
hexadecimal and EBCDIC 

Tracing facilities consist of the save 
area chain trace, the Trace Option and the 
Generalized Trace Facility. 

The save area chain enables tracing of 
the save areas for each level of load 
module in a task. The save area trace is 
displayed in ABEND/SNAP and storage dumps. 

The Trace Option, if installed in the 
system, provides records of system 
interruptions (10, SIO, etc.) that are 
displayed in ABEND/SNAP and storage dumps. 

The Generalized Trace Facility (GTF) 
enables selective tracing of system and 
application program events and records the 
information internally, in a table which is 
displayed in printouts of ABEND dumps and 
storage dumps, or externally in a data set 
which is processed by the IMDPRDMP service 
aid to provide edited and formatted GTF 
trace records. (For complete information 
on GTF see the Service Aids publication.) 
The GTF output, as processed by IMDPRDMP, 
is discussed in Section 3 of this 
publication. 
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General Notes ; • Control block field names referred to 

are those used in the IBM System/ 3 60 

• Displacements and addresses shown in Operating System: System Control 

the text and illustrations of this Blocks manual, GC28-6628. 
publication are given in decimal 

numbers, followed by the corresponding • Wherever possible, diagrams, and 

hexadecimal number in parentheses, reproductions of dumps have been 

e.g., TCB+ 14(E); location 28(1C); SVC included to aid you during the 

4 2(2A). All other numbers in the text debugging process, 
are decimal,, e.g., the seventeenth word 
of the TCB; a 4-word control block; 15 
job steps. 
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Section 1: Operating System Concepts 



This section introduces you to the control 
information that you must know to interpret 
dumps. It is divided into three topics: 

• task management 

• main storage supervision 

• system control blocks and tables 

The first two topics deal with those 
aspects of task management and main storage 
management, respectively,, that are 
represented in dumps. The third topic 
describes the remaining system control 
blocks and tables helpful in pinpointing 
errors . 

Note ; The descriptions of system control 
blocks and tables in this section emphasize 
function rather than byte- by-byte contents. 
Appendix K summarizes the contents of those 
control blocks most useful in debugging. 

For a more detailed description of 
system control blocks and tables, refer to 
the System Control Blocks publication, 
GC28-6628. 



Task Management 



The task management control information 
most useful in debugging with a dump 
includes the task control block and its 
associated request blocks and elements, 
the functions, interactions, and 
relationships to other system features of 
these items are discussed in this topic. A 
summary of how task supervision differs at 
each system level concludes the topic. 



Task Control Block 

The operating system keeps pointers to all 
information related to a task in a task 
control block (TCB). For the most part, 
the TCB contains pointers to other system 
control blocks. By using these pointers, 
you can learn such facts as what I/O 
devices were allocated to the task, which 
data sets were open, and which load modules 
were requested. 

Figure 1 shows some of the control 
information that can be located by using 
the pointers in the TCB. Later, in the 
discussion of system control blocks and 
tables, Figure 1 is expanded to show the 
actual block names and pointer addresses. 
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Figure 1. Control Information Available 
Through the TCB 



Request Blocks 

Frequently, the routines that comprise a 
task are not all brought into main storage 
with the first load module. Instead, they 
are requested by the task as it requires 
them. This dynamic loading capability 
necessitates another type of control block 
to describe each load module associated 
with a task — a request block (RB) . An RB 
is created by the control program when it 
receives a request from the system or from 
a problem program to fetch a load module 
for execution, and at other times, such as 
when a type II supervisor call (SVC) is 
issued. By looking at RBs, you can 
determine which load modules have been 
executed , why each lost control, and, in 
most cases, which one was the source of an 
error condition. 

There are seven types of RBs created by 
the control program: 

• Program request block (PRB) 

• Supervisor request block (SVRB) 

• Interrupt request block (IRB) 



Task Management 13 



• Supervisor interrupt request block 
(SERB) 

• Loaded program request block (LPRB) 

• Loaded request block (LRB) 

• Finch request block (FRB) 

Of these, you will most often encounter 
the PRB and SVRB in dumps. The type of RB 
created depends on the routine or load 
module with which it is associated. 

PRB (Systems with MFT) : A PRB is created 
whenever an XCTL, LINK, or ATTACH macro 
instruction is issued. It is located 
immediately before the load module with 
which it is associated. 



LRB (MFT only) : The LRB is a shortened 
form of an LPRB. Routines associated with 
LRBs can be invoked only by a LOAD macro 
instruction. This attribute is assigned to 
a routine through the OL (only loadable) 
subparameter in the PARM parameter of the 
EXEC statement that executes the linkage 
editor. The most common reason for 
assigning this attribute is that linkage 
conventions for XCTL, LINK, and ATTACH are 
not followed. This request block is 
located immediately before the load module 
with which it is associated. 



PRB (Systems with MVT) : A PRB is created 
whenever an XCTL or LINK macro instruction 
is issued. It is located in a fixed area 
of the operating system. 

SVRB : An SVRB is created each time a type 
II, III, or IV supervisor call is issued. 
(Type I SVC routines are resident, but run 
disabled; they do not require a request 
block.) This block is used to store 
information if an interruption occurs 
during execution of these SVC routines. A 
list of SVCs,, including their numbers and 
types , appears in Appendix A. 

IRB ; An IRB is created each time an 
asynchronous exit routine is executed. It 
is associated with an event that can occur 
at an unpredictable time during program 
execution, such as a timing routine 
initiated by an STIMER macro instruction. 
The IRB is filled at the time the event 
occurs, just before control is given to the 
exit routine. 

SIRB : An SIRB is similar to an IRB, except 
that it is associated only with 
IBM-supplied input/output error routines. 
Its associated error routine is fetched 
from the SYS1.SVCLIB data set. 

LPRB (MFT only) : An LPRB is created when a 
LOAD macro instruction is issued unless the 
LOAD macro instruction specifies: 

• A routine that has already been loaded. 

• A routine that is being loaded in 
response to a LOAD macro instruction 
previously issued by a task in the 
partition (MFT with subtasking) . 

• A routine that is "only loadable" (see 
LRB). 

An LPRB is located immediately before the 
load module with which it is associated. 
Routines for which an LPRB is created can 
also be invoked by XCTL, LINK, and ATTACH 
macro instructions. 



FRB (MFT with subtasking only) : An FRB is 
created and attached to the job pack area 
queue, during LOAD macro instruction 
processing, if the requested module is not 
already in the job pack area. The FRB 
describes a module being loaded in response 
to a LOAD macro instruction. Any 
subsequent requests for the same module, 
received while it is still being loaded, 
are deferred by means of wait list elements 
(WLEs) queued to the FRB. When the module 
is fully loaded, an LRB or an LPRB is 
created, the FRB is removed from the job 
pack area queue, and any requests,, 
represented by wait list elements, are 
reinitiated. 



Figure 2 shows the relative size of the 
seven types of RBs and the significant 
fields in each. 



In Figure 2, the "size" field tells the 
number of doublewords in both the RB and 
its associated load module. The PSW 
contained in the "resume PSW" field 
reflects the reason that the associated 
load module lost control. Other fields are 
discussed in succeeding topics. 

This far, the characteristics of the TCB 
and its associated RBs have been discussed. 
With the possibility of many RBs 
subordinate to one task, it is necessary 
that queues of RBs be maintained. In 
systems with MFT without subtasking, two 
queues are maintained by the system — the 
active RB queue and the load list. In MFT 
systems with subtasking, a job pack area 
queue, containing FRBs, and LRBs and LPRBs 
that represent reenterable modules is also 
maintained. MVT systems maintain an active 
RB queue and a contents directory. The 
contents directory is made up of three 
separate queues: the link pack area 
control queue (LPAQ) ; the job pack area 
control queue ( JPAQ) ; and the load list . 
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Figure 2. RB Formats 
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Active RB Queue 

The active RB queue is a chain of request 
blocks associated with active load modules 
and SVC routines. This queue can contain 
PRBs, SVRBs, IRBs, SIRBs, and under certain 
circumstances, LPRBs. Figure 3 illustrates 
how the active RB queue links together the 
TCB and its associated RBs. 




RB-A 



RB-B 



RB-C 




Figure 3. Active RB Queue 

The request blocks in the active RB 
queue in Figure 3 represent three load 
modules. Load module A invokes load module 
B, and B, in turn,, invokes C. When 
execution of A began, only one RB existed. 
When the first invoking request was 
encountered, a second RB was created, the 
TCB field that points to the most recent RB 
was changed,, and A's status information was 
stored in RB-A. A similar set of actions 
occurred when the second invoking request 
was encountered. As each load module is 
executed and control is returned to the 
next higher level load module, its RB is 
removed from the chain and pointers are 
updated accordingly. 

Load List 

The load list is a chain of request blocks 
or elements associated with load modules 
invoked by a LOAD macro instruction. The 
load list differs from the active RB queue 
in that RBs and associated load modules are 
not deleted automatically. They remain 
intact until they are deleted with a DELETE 
macro instruction or job step termination 
occurs. By looking at the load list, you 
can determine which system and problem 



program routines were loaded before the 
dump was taken. The format of the load 
list differs with control program levels. 

Systems with MFT (without subtasking) : At 
this control program level, the load list 
associated with a TCB contains LRBs and 
LPRBs. RBs on the load list are linked 
together somewhat differently from those on 
the active RB queue because of the 
characteristics of the LOAD macro 
instruction. Because RBs may be deleted 
from a load list in a different order than 
they were created (depending on the order 
of DELETE macro instructions), they must 
have both forward and backward pointers. 
Figure 4 illustrates how a load list links 
together a TCB and three RBs. 



RB-A 



m 



f RB-B 



mi 



<£ 



£> 




fRB-A 


fltt-C 




tB 





Figure 4. Load List (MFT) 

Here, each RB contains a pointer both to 
the previous RB and the next most recent RB 
in the list. If there is no previous or 
more recent RB, these fields contain zeros 
and a pointer to the TCB, respectively. 

Another field of a load list RB that 
merits consideration is the use count. 
Whenever a LOAD macro instruction is 
issued, the load list is searched to see if 
the routine is already loaded. If it is 
loaded, the system increments the use count 
by one and passes the entry point address 
to the requesting routine. 

Each time a DELETE macro instruction is 
issued for the routine, the use count is 
decremented by one. When it reaches zero, 
the RB is removed from the load list and 
storage occupied by the associated routine 
is freed . 
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Systems With MFT (With Subtasking) ; At 
this control program level, the load list 
is used as described for MFT without 
subtasking, with the following exceptions: 

1. The LRBs and LPRBs queued on the load 
list represent modules that are not 
reenterable. LRBs and LPRBs 
representing reenterable modules are 
queued on the job pack area queue. 

2. When a LOAD macro instruction is 
issued, the system searches the job 
pack area queue before searching the 
load list. 



reaches zero. An LLE has the following 
format : 



ft«& 



t N«xt LIE 



Count 



fCOE 



Byte : Reserved (RES) . 

Bytes 1-3: Pointer to the next more recent 
LLE on the load list. 



Systems With MVT : Instead of LRBs and 
LPRBs created as a result of LOAD macro 
instructions, the load list maintained by a 
system with MVT contains elements 
representing load modules. Load list 
elements (LLEs) are associated with load 
modules through another control medium 
called the contents directory . 

The contents directory is made up of 
three separate queues: the link pack area 
control queue (LPAQ) . the job pack area 
control queue (JPAQ) , and the load list . 

The LPAQ is a record of every program in 
the system link pack area. This area 
contains reenterable routines specified by 
the control program or by the user. The 
routines in the system link pack area can 
be used repeatedly to perform any task of 
any job step in the system. The entries in 
the LPAQ are contents directory entries 
(CDEs). 

There is a JPAQ for each job step in the 
system that uses a program not in the link 
pack area. The JPAQ, like the LPAQ, is 
made up of CDEs. It describes routines in 
a job step region. The routines in the job 
pack area can be either reenterable or not 
reenterable. These routines however, 
cannot be used to perform a task that is 
not part of the job step. 

The load list represents routines that 
are brought into a job pack area or found 
in the link pack area by the routines that 
perform the Load function. The entries in 
the load list are load list elements, not 
CDEs. Each load list element is associated 
with a CDE in the JPAQ or the LPAQ; the 
programs represented in the load list are 
thus also represented in one of the other 
contents directory queue s- 

Load list elements also contain a count 
field that corresponds to the use count in 
a LPRB or LRB. Each time a LOAD macro 
instruction is issued for a load module 
already represented on the load list, the 
count is incremented by one. As 
corresponding DELETE macro instructions are 
issued, the count is decremented until it 



Byte 4: 



Count. 



Bytes 5-7: Pointer to the corresponding 
CDE. 

More will be said about CDEs in the next 
topic of Section 1, titled "Main Storage 
Supervision. " 

Job Pack Area Queue (MFT With Subtasking 
Only) 

In an MFT system with subtasking, the job 
pack area queue is a chain of request 
blocks associated with load modules invoked 
by a LOAD macro instruction. The queue 
contains FRBs, and those LRBs and LPRBs 
that represent reenterable modules. FRBs 
are queued on the job pack area queue until 
the requested module is completely loaded. 
When the module is completely loaded into 
main storage, the FRB is removed from the 
job pack area queue and replaced with an 
LBR or an LPR queue on the job pack area 
queue if the loaded module is reenterable, 
and on the load list if it is not. 

In the MFT with subtasking 
configuration, the load list represents 
non-reenterable modules, while the jot pack 
area queue represents cnly reenterable 
modules within the partition. These RBs on 
the job pack area queue are not deleted 
automatically, but remain intact until they 
are deleted by a DELETE macro instruction, 
or until job step termination occurs. 
Reenterable load modules are therefore 
retained in the partition for use by the 
job step task or any subtasks which may be 
created. 

Whenever a LOAD macro instruction is 
issued, the job pack area queue is 
searched. If the routine is already fully 
loaded and represented by an LRB or an LPRB 
on the JPAQ (the routine is reenterable), 
the system increments the use count by one 
and passes the module entry point address 
to the requesting routine. If an FRB for 
the requested module is found, a wait list 
element (WLE) representing the deferred 
request is queued to the FRB, and the 
request is placed in a wait. When the 
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requested routine is fully loaded, the 
system releases the request from the wait 
condition, and the request is re-initiated. 
If no RB for the requested routine is 
found, an FRB is created and queued on the 
JPAQ. The system then searches the load 
list of the requesting task for an RB for 
the requested routine. If an RB for that 
routine is found on the load list (the 
routine is not reenterable) , the use count 
is incremented by one, the entry point 
address of the module is passed to the 
requesting routine, and the FRB is dequeued 
from the JPAQ. If no RB is found on the 
load list, the FRB remains on the JPAQ and 
the system begins loading the requested 
module. 



Each time a DELETE macro instruction is 
issued for the routine, the use count is 
decremented by one (the DELETE routine 
ignores FRBs). When the use count reaches 
zero, the RB is removed from the queue. 



Figure 5 illustrates how the job pack area 
queue is chained to a TCB. 

In Figure 5, each RB contains a pointer to 
the previous RB and a pointer to the next 
RB on the queue. If there is no previous 
RB on the queue, that pointer will contain 
zero; if there is no next RB on the queue 
(this RB is the most recent on the JPAQ) , 
the next RB pointer will point back to the 
job pack area queue pointer in the PIB. 




Figure 5. Job Pack Area Queue 



Two wait list elements (WLEs) are queued 
to FRB-C representing deferred requests 
waiting until the initial loading of the 
module is completed. The last WLE contains 
zero in its forward pointer, indicating 
that it is the last element on the WLE 
queue. 

Effects Of LINK, ATTACH, XCTL, and LOAD 

LINK, ATTACH, XCTL, and LOAD, though 
similar, have some distinguishing 
characteristics and system dependencies 
worth mentioning. By knowing what happens 
when these macro instructions are issued, 
you can make more effective use of the 
active RB queue and the load list. 

LINK : A LINK results in the creation of a 
PRB chained to the active RB queue. Upon 
completion of the invoked routine, control 
is returned to the invoking routine. In 
systems with MFT, the RB is removed from 
the queue. The storage occupied by the 
invoked routine is freed unless the routine 
is also represented on the load list, or on 
the job pack area queue in MFT systems with 
subtasking. In systems with MVT, the use 
count in the CDE is decremented by one; if 
it is then zero, the RB and the storage 
occupied by the routine are marked for 
deletion. A LINK macro instruction 
generates an SVC 6. 

ATTACH : An ATTACH is similar to the other 
three macro instructions in systems with 
MFT without subtasking. In systems with 
MFT with subtasking or MVT, ATTACH is the 
means for dynamically creating a separate 
but related task — a subtask. 

At the MFT without subtasking level, 
ATTACH effectively performs the same 
functions as LINK with two notable 
additions: 

1. You can request an exit routine to be 
given control upon normal completion 
of the attached routine. 

2. You can request the posting of an 
event control block upon the routine's 
completion. 

Exit routines are represented by additional 
RBs on the active RB queue. The ATTACH 
macro instruction generates an SVC 42 (2A). 

XCTL : An XCTL also results in the creation 
of a PRB and immediate transfer of control 
to the invoked routine. However, XCTL 
differs from the other macro instructions 
in that, upon completion of the invoked 
routine, control is passed to a routine 
other than the invoking routine. In fact, 
an XCTL does not result in the creation of 
a lower level RB. Instead, the invoking 
routine and its associated RBs are deleted 
when the XCTL is issued. In effect, the RB 
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for the invoked routine replaces the 
invoking routine's RB. The XCTL macro 
instruction generates an SVC 7. 

LOAD ; The LOAD macro instruction was 
treated previously in the discussion of the 
load list- To summarize: the system 
responds to a LOAD by fetching the routine 
into main storage and passing the entry 
point address to the requesting routine in 
register 0. Because the system does not 
have an indication of when the routine is 
no longer needed, a LOAD must be 
accompanied by a corresponding DELETE macro 
instruction. If not, the routine and its 
RB remain intact until the job step is 
terminated. The LOAD macro instruction 
generates an SVC 8. 

System Task Control Differences 

Thus far, this topic has dealt with the 
aspects of task supervision that are 
similar for MFT and MVT. There are, 
however, some major differences: 

1. The number of tasks that can be known 
to the system concurrently. 

2. The layout of main storage. 

3. The additional main storage control 
information in systems with MVT. 

The first two subjects are discussed 
here,, by system. The third subject, 
because of its volume, is discussed in the 
next topic of Section 1. 

Systems With MFT (Without Subtaskinq) 

Figure 6 is a snapshot of main storage in a 
system with MFT without subtasking. 

The fixed area contains the nucleus 
(including TCB queue, transient area 
loading task, communications task, and 
master scheduler task), and the system 
queue area. Optionally it may contain 
access methods and SVC routine which are 
normally nonresident, a list of absolute 
addresses for routines which reside on 
direct access devices, and a reenterable 
load module area. 

One TCB exists for each task. All TCBs 
are linked by dispatching priority in a TCB 
queue, beginning with the three resident 
tasks . 

The dynamic area is divided into a 
maximum of 52 partitions. Each partition 
contains one task. The dynamic area can 
contain as many as 3 reading tasks, 36 
writing tasks, and 15 job step tasks, 
providing that the total number of tasks 
does not exceed 52. Partition sizes and 
attributes are defined during system 
generation. Figure 7 shows the contents of 
an MFT partition. 




Figure 6. Main Storage Snapshot (MFT 
Without Subtasking) 




Figure 7. Partition (MFT Without 
Subtasking) 
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Jobs are processed sequentially in a 
partition, one job step at a time. An 
ATTACH macro instruction does not create a 
sub task. 



Systems with MFT (With Subtasking) : 
Operating Systems that provide 
multiprogramming with a fixed number of 
tasks with the subtasking option (MPT with 
subtasking) differ from MFT systems without 
subtasking in the following major areas: 



1. MFT with subtasking has an ATTACH 
facility similar to the ATTACH 
facility in MVT. While the number of 
job step TCBs still may not exceed 15, 
the number of tasks in any partition, 
and therefore the total number of 
tasks in the system, is now variable. 
Job step task TCBs reside in the 
nucleus. They are queued, following 
the system task TCBs, in the same 
manner as in MFT without subtasking. 
When subtasks are created, however, 
the subtask TCBs are placed in the 
system queue area and queued to the 
job step TCBs according to dispatching 
priority (TCBTCB field), and according 
to subtask relationships (TCBNTC, 
TCBOTC, TCBLTC fields). 



2. MFT with subtasking provides the 
ability to change the dispatching 
priority of any task within a 
partition through the use of the CHAP 
macro instruction. 



Figure 8 is a snapshot of main storage in 
an MFT system with subtasking. Note here 
that the TCBs in the nucleus are all job 
step TCBs, while those residing in the 
sytem queue area are the subtask TCBs. 



Systems with MVT t In Operating Systems 
that provide multiprogramming with a 
variable number of tasks (MVT), as many as 
15 job steps can be executed concurrently. 
Each job step requests an area of main 
storage called a region and is executed as 
a job step task . In addition, system tasks 
request regions and can be executed 
concurrently with job step tasks. 



Regions are assigned automatically from 
the dynamic area when tasks are initiated. 
Regions are constantly redefined according 
to the main storage requirements of each 
new task. 




FIXED 
AREA 



Figure 8 , 



Main Storage Snapshot (MFT With 
Subtasking) 



With the facility of attaching subtasks 
available to each task through the ATTACH 
macro instruction, the number of TCBs in 
the system is variable. Tasks gain control 
of the CPU by priority. To keep track of 
the priority and status of each task in the 
system, TCBs are linked together in a TCB 
queue. 

Figure 9 is a snapshot of main storage 
in a system with MVT. The fixed area is 
occupied by the resident portion of the 
control program loaded at IPL. The system 
queue space is reserved for control blocks 
and tables built by the control program. 
The dynamic area is divided into 
variable -sized regions, each of which is 
allocated to a job step task or a system 
task. Finally, the link pack area contains 
selected reenterable routines, loaded at 
IPL. If an IBM' 2361 Core Storage device 
and Main Storage Hierarchy Support are 
included in the system, a secondary link 
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pack area may be created in hierarchy 1 to 
contain other reenterable routines. 



Storage Control in Systems with MFT 
(Without Subtasking) 




Figure 9. Main Storage Snapshot (MVT) 



Main Storage Supervision 

Storage control information is kept in a 
series of control blocks called queue 
elements . In systems with MFT without 
subtasking, queue elements reflect areas of 
main storage that are unassigned. In MFT 
systems with subtasking, a gotten sub task 
area queue element (GQE) is introduced to 
record storage obtained for a subtask by a 
supervisor issued GETMAIN macro 
instruction. In systems with MVT, more 
elaborate storage control is maintained; at 
any given time, queue elements reflect the 
distribution of main storage in regions, 
subpools, and load modules. 

The dynamic area may be significantly 
expanded by including IBM 2361 Core Storage 
in the system. Main Storage Hierarchy 
Support for IBM 2361 Models 1 and 2 permits 
selective access to either processor 
storage (hierarchy 0) or 2361 Core Storage 
(hierarchy 1). If IBM 2361 Core Storage is 
not included, requests for storage from 
hierarchy 1 are obtained from hierarchy 0. 
If 2361 Core Storage is not present in an 
MVT system and a region is defined to exist 
in two hierarchies, a two-part region is 
established within processor storage. The 
two parts are not necessarily contiguous. 



The chain of storage control information in 
an MFT system without subtasking begins at 
a table called the main storage supervisor 
(MSS) boundary box, located in the system 
nucleus. There is one MSS boundary box for 
each partition. It is pointed to by the 
TCB (TCBMSS field) for the partition. 

Each boundary box contains 3 words. The 
first word points to the Free Queue Element 
(FQE) associated with the highest free area 
in the partition. The second word points 
to the lowest limit of the partition. The 
third word contains the highest address in 
the partition plus 1. 

If Main Storage Hierarchy Support is 
included, the first half of each expanded 
boundary box describes the processor 
storage (hierarchy 0) partition segment, 
and the second half describes the 2361 Core 
Storage (hierarchy 1) partition segment. 
Any partition segment not currently 
assigned storage in the system has the 
applicable boundary box pointers set to 
zero. If the partition is established 
entirely within hierarchy 0, or if 2361 
Core Storage is not included in the system, 
the hierarchy 1 pointers in the second half 
of the expanded boundary box are set to 
zero. If a partition is established 
entirely within hierarchy 1, the hierarchy 
pointers in the first half of the 
expanded boundary box are set to zero. 



FQE : Each free area in a partition is 
described by an FQE. FQEs are chained 
beginning with the FQE associated with the 
free area having the highest address in the 
partition. If Main Storage Hierarchy 
Support is present, one FQE chain exists 
for each hierarchy specified. Each FQE 
occupies the first 8 bytes of the area it 
describes. It has the following format: 



1 Next FQE I 



Number of bytes 



Bytes 0-3: Pointer to FQE associated with 
next lower free area or, if 
this is the last FQE, zeros. 



Bytes 4-7: Number of bytes in the free 
area. 

Figure 10 summarizes storage control in 
systems with MFT without subtasking. 
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Storage Control for a Partition 
(MFT Without Subtasking) 



Storage Control in Systems with MFT (With 
Subtasking) 

Storage control information for the job 
step or partition TCB in MFT systems with 
subtasking is handled in the same way as in 
MFT systems without subtasking. However, 
when subtasks are created, the supervisor 
builds another control block, the gotten 
subtask area gueue element (GQE). The GQEs 
associated with each subtask originate from 
a one word pointer addressed by the TCBMSS 
field of the subtask TCB. 



GQE : Each area in main storage belonging 
to a subtask,, and obtained by a supervisor 
issued GETMAIN macro instruction, is 
described by a gotten subtask area gueue 
element (GQE). GQEs are chained in the 
order they are created. The TCBMSS field 
of the subtask TCB contains the address of 
a word which points to the most recently 
created GQE. 



If Main Storage Hierarchy Support is 
present in the system, the GQE chain can 
span from hierarchy to hierarchy 1 and 
back in any order. Each GQE occupies the 
first eight bytes of the area it describes, 
and has the following format: 



Bytes 0-3: Pointer to the Previous GQE or, 
if zero, this is the last GQE 
on the chain. 

Bytes 4-7: Number of bytes in the gotten 
subtask area. 

Figure 11 summarizes the chaining of GQEs 
to a subtask TCB. 
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PARTITIONS 
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Figure 11. Storage Control for Subtask 

Storage (MFT With Subtasking) 

Storage Control for a Region in Systems 
with MVT 

Unassigned areas of main storage within 
each region of a system with MVT are 
reflected in a queue of partition queue 
elements (PQEs) and a series of free block 
queue elements (FBQEs) . 
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PQE : The partition queue associated with a 
region resides in the system queue space.. 
It is connected to the TCBs for all tasks 
in the job step through a dummy PQE located 
in the system queue space- A dummy PQE has 
the following format: 



!"• — 

J First PQE 


f Last PQE 



Bytes 13-15 (D-F) : Pointer to the previous 
PQE or, if this is the first 
PQE, zeros. 

Bytes 17-19(11-13): Pointer to the TCB of 
the owning job step. 

Bytes 21-23(15-17): Size of the region, in 
2K (2048) bytes. 



Bytes 25-27 (19-1B) : Pointer to the first 
byte of the region. 



Bytes 0-3: Pointer to the first PQE in the 
partition queue. 

Bytes 4-7: Pointer to the last PQE in the 
partition queue. 

In systems that do not include the 
rollout/rollin feature or Main Storage 
Hierarchy Support for IBM 2361 Models 1 and 
2, there is one PQE for each job step. If 
the rollout feature is used, additional 
PQEs are added each time a job step borrows 
storage space from existing steps or 
acquires unassigned free space to satisfy 
an unconditional GETMAIN request. These 
additional PQEs are removed from the queue 
as the rollin feature is used. If Main 
Storage Hierarchy Support is present, one 
PQE exists for each hierarchy used by the 
job step. A PQE has the following format: 



Byte 28 (1C): Rollout flags. 



FBQE : The FBQEs chained to a PQE reflect 
the total amount of free space in a region. 
Each FBQE is associated with one or more 
contiguous 2K blocks of free storage area. 
FBQEs reside in the lowest part of their 
associated area. As area distribution 
within the region changes, FBQEs are added 
to and deleted from the free block queue. 

An FBQE has the following format: 



mh 



Next FBQE 



Res 



Previous FBOE 



Res 



Number of byres 



R«t 



16 (10) 



Res 



24(18) 



|f First F8QE 



; f Next PQE 



12(C) 



I f Owning TCB 



17(11) 



20(14) 



25 (19) 



28 (1C) 



13(D) 



Region Size 



21 (15) 



Res 



29 (ID) 



Bytes 1-3: Pointer to the first FBQE or, 
if there are no FBQEs, a 
pointer to the PQE itself. 

Bytes 5-7: Pointer to the last FBQE or, if 
there are no FBQEs, a pointer 
to the PQE itself. 

Bytes 9-11 (B): Pointer to the next PQE or, 
if this is the last PQE,, zeros. 



Bytes 1-3: Pointer to the next lower FBQE 
or, if this is the last FBQE, a 
pointer to the PQE. 

Bytes 5-7: Pointer to the preceding FBQE, 
or, if this is the first FBQE, 
a pointer to the PQE. 



Bytes 8-11 (B): 



Number of bytes in the free 
block. 



The remaining main storage in a region 
is used by problem programs and system 
programs. For convenience in referring to 
storage areas, the total amount of space 
assigned to a task represents one or more 
numbered sub poo Is . (Subpools can also be 
shared by tasks.) Subpools are designated 
by a number assigned to the area through a 
GETMAIN macro instruction. Subpool numbers 
available for problem program use range 
from through 127. Subpool numbers 128 
through 255 are either unavailable or used 
by system programs. 

Storage control elements and queues for 
a region are summarized in Figure 12. 
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DYNAMIC 
AREAS 



SYSTEM 
QUEUE < 
SPACE 




Bytes 1-3: Pointer to next SPQE or, in 
last SPQE, zero. 



Byte 4: Subpool number. 



Bytes 5-7: Pointer to first DQE or, if the 
subpool is shared, a pointer to 
the "owning" SPQE. 



DQE : DQEs associated with each SPQE 
reflect the total amount of space assigned 
to a subpool. Each DQE is associated with 
one or more 2K blocks of main storage set 
aside as a result of a GETMAIN macro 
instruction. Each DQE is also the starting 
point for the free queue. A DQE has the 
following format: 



Res 


t First FQE 


Res 


t Next DQ£ > 


1 4 5 


) Res 


f Rrsf 2K block 


Res 


Length of area 



Figure 12. Storage Control for a Region 
(MVT) 



12(C) 13(D) 



Storage Control for a Subpool in Systems Bytes 1-3: 
with MVT 



Pointer to the FQE associated 
with the first free area. 



Main storage distribution within each 
subpool is reflected in a subpool queue 
element (SPQE) and queues of descriptor 
queue elements (DQEs) and free queue 
elements (FQEs). 

SPQE ; SPQEs are associated with the 
subpools created for a task. SPQEs reside 
in the system queue space and are chained 
to the TCB(s) that use the subpool. They 
serve as a link between the TCB and the 
descriptor queue, and may be part of a 
subpool queue if the task- uses more than 
one subpool. If a subpool is used by more 
than one task, only one SPQE is created. 
An SPQE has the following format: 



Wfc/i, , 


| Next SPQE 


Sl> # 


t First DQE 



Byte 0: 
Bit 



- Subpool is owned by this task 
if zero; shared, and owned by 
another task, if one. 
Bit 1 - This SPQE is the last on the 

queue, if one- 
Bit 2 - Subpool is shared and owned by 

this task, if one. 
Bits 3-7 - Reserved. 



Bytes 5-7: Pointer to the next DQE or, if 
this is the last DQE, zeros. 

Bytes 9-11 (B) : Pointer to first 2K block 
described by this DQE. 

Bytes 13-15 (D-F): Length in bytes of area 
described by this DQE. 

FQE : The FQE describes a free area within 
a set of 2K blocks described by a DQE. It 
occupies the first eight bytes of that free 
area. Since the FQE is within the subpool, 
it has the same protect key as the task 
active within that subpool. Extreme care 
should be exercised to see that FQEs are 
not destroyed by the problem program. If 
an FQE is destroyed, the free space that it 
describes is lost to the system and cannot 
be assigned through a GETMAIN. As area 
distribution within the set of blocks 
changes, FQEs are added to and deleted from 
the free queue. An FQE has the following 
format: 
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Bytes 1-3: Pointer to the next lower FQE 
or, if this is the last FQE, 
zeros. 



Bytes 5-7: Number of bytes in the free 
area. 



Storage control for a subpool is 
summarized in Figure 13. 



DYNAMIC. 
AREAS s 




Figure 13. Storage Control for a Subpool 
(MVT) 



Storage Control for a Load Module in 
Systems With MVT 

Each load module in main storage is 
described by a contents directory entry 
(CDE) and an extent list (XL) that tells 
how much space it occupies. 



CDE : The contents directory is a group of 
queues, each of which is associated with an 
area of main storage. The CDEs in each 
queue represent the load modules residing 
in the associated area. There is a CDE 
queue for the link pack area and one for 
each region, or job pack area. The TCB for 
the job step task that requested the region 
Contents directory queues reside in the 
system queue space. A CDE has the 
following format: 



■Nogs 


t Next CDE 


Res 


^^^^^^^^^fcW 





1 4 5 




!=-■-■ ( 

Vs : EBCDIC program nom« J 


8 


\ 

1 Count 


f Entry point 


flogs 


fXL 



16(10) 17(11) 



20(14) 21(15) 



Byte 0: Flag bits, when set to one, 
indicate: 
Bit - Module was loaded by NIP. 
Bit 1 - Module is in process of being 

loaded. 
Bit 2 - Module is reenterable. 
Bit 3 - Module is serially reusable. 
Bit 4 - Module may not be reused. 
Bit 5 - This CDE reflects an alias 

name (a minor CDE) . 
Bit 6 - Module is in job pack area. 
Bit 7 - Module is not only- loadable. 



Bytes 1-3: Pointer to next CDE. 

Bytes 5-7: Pointer to the RB. 

Bytes 8-15 (F): EBCDIC name of load module. 

Byte 16(10): Use count. 



Bytes 17-19(11-13): Entry point address of 
load module. 



Byte 20: Flag bits, when set to one, 

indicate : 
Bit - Reserved. 
Bit 1 - Module is inactive. 
Bit 2 - An extent list has been built 

for the module. 
Bit 3 - This CDE contains a relocated 

alias entry point address. 
Bit 4 - The module is refreshable. 
Bits 5, 6, 7 - Reserved. 



Bytes 21-23(15-17): Pointer to the XL for 
this module or, if this is a 
minor CDE, pointer to the 
major CDE. 



XL : The total amount of main storage 
occupied by a load module is reflected in 
an extent list (XL) . XLs are located in 
the system queue space. An XL has the 
following format: 
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!< Length of XL 



! Number of CSICW 



! Length of CSECT- 1 



Length of ( / CSECT - N j 



12(C) 



I Location <rf CSECT - 1 1 



\ Location of f ( CSECT - N I 



Bytes 0-3: Length of XL in bytes- 
Bytes 4-7: Number of scattered control 
sections. If the control 
sections are block-loaded, 1. 

Remaining Length in bytes of each 

bytes : control section in the module 
(4 bytes for each control 
section) and starting location 
of each control section (4 
bytes for each control 
section) . 




Figure 14. Storage Control for a Load 
Module (MVT) 



Storage control elements and queues for 
load modules are summarized in Figure 14. 



System Control Blocks and Tables 



In addition to the key task management 
control blocks (TCB and RB), several other 
control blocks containing essential 
debugging information are built and 
maintained by data management and job 
management routines. Although some of 
these blocks are not readily identifiable 
on a storage dump, they can be located by 
following chains of pointers that begin at 
the TCB. 



The control blocks discussed here have 
the same basic functions at each control 
program level. The precise byte-by-byte 
contents of the blocks can be found in the 
publication System Control Blocks . Block 
contents useful in debugging are listed in 
Appendix K. 



Communications Vector Table (CVT) 

The CVT provides a means of communication 
between nonresident routines and the 
control program nucleus. Its most 
important role in debugging is its pointer 
to two words of TCB addresses. These words 
enable you to locate the TCB of the active 
task, and from there to find other 
essential control information. Storage 
locations 16(10) and 76 (4c) contain a 
pointer to the CVT. 



Task Input/Output Table (TIOT) 

A TIOT is constructed by job management for 
each task in the system. It contains 
primarily pointers to control blocks used 
by I/O support routines. It is usually 
located in the highest part of the main 
storage area occupied by the associated 
task (in systems with MVT, TIOTs are in the 
system queue space.) Through the TIOT, you 
can obtain addresses of unit control blocks 
allocated to the task, the job and step 
name, the ddnames associated with the step, 
and the status of each device and volume 
used by the data sets. 
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Unit Control Block (UCB) 

The UCB describes the characteristics of an 
I/O device. One UCB is associated with 
each I/O device configured into a system. 
The UCB's most useful debugging aid is the 
sense information returned by the last 
sense command issued to the associated 
device. 



to some other control blocks. The DEB is 
created and queued to the TCB at the time a 
data set is opened. Each TCB contains a 
pointer to the first DEB on its chain. 
Through this pointer you can find out which 
data sets are opened for the task at a 
given time, what extents are occupied by 
open data sets, and where the DCB and UCB 
are located. 



Event Control Block (ECB) 

The ECB is a 1-word control block created 
when a READ or WRITE macro instruction is 
issued, initiating an asynchronous I/O 
operation. At the completion of the I/O 
operation, the access method routine posts 
the ECB. By checking this ECB, the 
completion status of an I/O operation can 
be determined. In all access methods but 
QTAM, the ECB is the first word of a larger 
block, the data event control block. 

Input/Output Block (IOB) 

The IOB is the source of information 
required by the I/O supervisor. It is 
filled in with information taken from an 
I/O operation request. In debugging, it is 
useful as a source of pointers to the DCB 
associated with the I/O operation and the 
channel commands associated with a 
particular device. 

Data Control Block (DCB) 

The DCB is the place where the operating 
system and the problem program store all 
pertinent information about a data set. It 
may be completely filled by operands in the 
DCB macro instruction, or partially filled 
in and completed when the data set is 
opened, with subparameters in a DD 
statement and/or information from the data 
set label. The format of DCBs differs 
slightly for each of the various access 
methods and device types. The DCB's 
primary debugging aids are. its pointers to 
the DEB and current IOB associated with its 
data set, and the offset value of the 
ddname in the TIOT. 

Data Extent Block (DEB) 

A DEB describes a data set's auxiliary 
storage assignments and contains pointers 



Summary of Control Block Relationships 

Figure 15, an expansion of Figure 1, shows 
the relationships among the principal 
control blocks and tables in the System/360 
Operating System. 



Location 
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C V T 
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Figure 15. Control Block Relationships 



System Control Blocks and Tables 27 



28 Programmer's Guide to Debugging (Release 21) 



Section 2: Interpreting Dumps 



Topics composing section 2 are: 

• ABEND/ SNAP dumps issued by systems with 
MPT. 

• ABEND/SNAP dumps issued by systems with 
MVT. 

• Indicative dumps. 

• Storage dumps. 

Each topic includes instructions for 
invoking the dump, a detailed description 
of the dump's contents, and a guide to 
using the dump. 



ABEND/SNAP Dump (MFT) 

ABEND/ SNAP storage dumps are issued 
whenever the control program or problem 
program issues an ABEND or SNAP macro 
instruction, or the operator issues a 
CANCEL command requesting a dump, and 
proper dump data sets have been defined. 
However, in the event of a system failure, 
if a SYS1..DUMP data set has been defined 
and is available, a full storage dump will 
be provided, as explained in the section 
"Storage Dumps. " 

Since, in an MFT with subtasking system, 
subtasks may be created, you may receive 
one or more partial dumps in addition to 
the complete dump of the task that caused 
the abnormal termination. A complete dump 
includes a printout of all control 
information related to the terminating 
task, and the nucleus and all allocated 
storage within the partition in which the 
abending task resided. A partial dump of a 
task related to the terminating task 
includes only control information. The 
partial dump is identified by either ID=001 
or ID=002 printed in the first line of the 
dump. Figure 16 is a copy of the first few 
pages of a complete ABEND dump of an MFT 
system with subtasking. It illustrates 
some of the key areas on an ABEND dump, as 
issued by systems with MFT. Those portions 
of the dump that would only appear on a 
dump of a subtasking system are noted in 
the later discussions as appearing only in 
a dump of an MFT with subtasking system. 

For a discussion of a formatted ABEND 
dump using the telecommunications access 
method (TCAM) in an MFT environment, see 
IBM Svstem/360 Operating System: TCAM 
Program Logic Manual ,, GY30-2029. 
References to other TCAM debugging aids are 
found in Appendix J. 



Invoking an ABEND/SNAP Dump (MFT) 

ABEND dumps are produced as a result of an 
ABEND macro instruction, issued either by a 
processing program or an operating system 
routine. The macro instruction requires a 
DD statement in the input stream for each 
job step that is subject to abnormal 
termination. This DD statement must be 
identified by one of the special ddnames 
SYSABEND or SYSUDUMP . SYSABEND results in 
edited control information, the system 
nucleus, the trace table, and a dump of 
main storage; SYSUDUMP excludes the nucleus 
and the trace table. In the event of a 
system failure, the Damage Assessment 
routine (DAR) attempts to write a storage 
image dump to the SYS1.DUMP data set. A 
full explanation of storage dumps may be 
found in the section "Storage Dumps." 



SNAP Dumps result from a problem program 
issuing a SNAP macro instruction. The 
contents of a SNAP dump vary according to 
the operands specified in the SNAP macro 
instruction. SNAP dumps also require a DD 
statement in the input stream. This DD 
statement has no special characteristics 
except that its ddname must not be SYSABEND 
or SYSUDUMP. The processing program must 
define a DCB for the snapshot data set. 
The DCB macro instruction must contain, in 
addition to the usual DCB requirements, the 
operands DSORG=PS, RECFM=VBA, MACRF-(W), 
BLKSIZE=882 or 1632, and LRECL=125. In 
addition, the DCB must be opened before the 
first SNAP macro instruction is issued. 



Main Storage Considerations : Three BSAM 
modules (IGG019BA, IGG019BB, and the 
device-dependent EOB module) are required 
to process dumps. These modules should be 
made resident in the Resident Access Method 
(RAM) area by specifying RESIDNT=ACSMETH in 
the SUPRVSOR macro instruction during 
system generation. If these modules are 
not resident, as much as 1352 bytes of main 
storage within the partition are required 
to contain them,. 



In addition to the area required for the 
BSAM modules, 2784 bytes must be available 
in the partition. 1344 of these bytes are 
required for EOV processing should the 
initial space specification for a direct 
access device be exceeded by the dump 
requirements. 
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* ABDUMP REQUESTED * 










JOB ATHE0T24 STEP STEP TIME 


000737 DATE 99366 


PAGE 0001 






COMPLETION CODE USER = 0123 










INTERRUPT AT 06EF5A 










PSW AT ENTRY TO ABEND 00150000 4006EF5A 










TCB 01CB20 RB 0007FC58 PIE OOOOOOOO 
MSS 0001CC58 PK/FLG 10B10408 
FSA 1506EBF8 TCB 000100AO 


DE8 0007F78C TIOT 
FLG 000001FB LLS 
TME 0001CB08 PIB 


0007FD80 CMP 8O0OOO7B TRN OOOOOOOO 
OOOOOOOO JLB 0007FF78 JST 000055D8 




STAE OOOOOOOO TCT OOOOOOOO 


USER OOOOOOOO DAR 


OOOOOOOO RESV OOOOOOOO JSCB OOOOOOOO 




ACTIVE RBS 










PRB 06EE28 NM TATHB10G SZ/STAB 003D20DO 


USE/EP 0106EE48 PSW 


I 00150000 4006EF5A Q 000000 WT/LNK 0001CB20 






SVRB 07F020 NM SVC-601C SZ/STAB 00120062 
RG 0-7 000002A0 8000007B 
8-15-7 0006EE60 0007FF78 


USE/EP 00007B78 PSW 
OOOOOOOO 00080000 
0007FFBO 0007FFF8 


FF040033 50007D20 Q 900390 WT/LNK 0006EE28 
0007FE48 00000098 00005508 0007FC30 
4006EE4E 0006EE60 00009848 OOOOOOOO 






SVRB 07FC58 NM SVC-A05A SZ/STAB 000C0062 
RG 0-7 0007F7E8 0007FD80 
8-15-7 0007F7E8 0006F296 


USE/EP 00007B78 PSW 
4000787A 000097F8 
0001CC56 0000225C 


FF04000E 8001E7EC Q F803F8 WT/LNK 0OO7FD20 
0001C820 0007FD20 0006F230 00005508 
0001C820 0006F230 90007CBC 0001E7C8 




tPRB 06ECA8 NM TATHAIOG SZ/STAB 002P2000 J 


USE/EP O106&CC8 PSH 




FF15000E 80O6EO9C 000000 WT/LNK 01OICDEO 




LPR8 06ES28 MM TATH610G SZ/STA& 00302000 


USE/EP 0106664$ PSW 


00150Q0D 4006EF5A 4 000000 WT/LNK 0001CB20 






LPR& 06F018 .NM TATHC10C SZ/STAB 00122090 


US6/£P OIO6F038 PSW 


00040000 40006AE4 000090 WT/LNK 0001CC80 






LPRB 06FOB0 NM TATH010G SZ/STA8 0QIB20QO 


USE/EP 0106FO0O PSW 


FF15Q0OI 4006FH&C 4 000000 WT/LNK O101DOAO 






LPRB 06F190 AM TATHE10G SZ/STAB 00132000 


USE/EP 0106F180 PS» 


FF150001 4006F21E Q 000000 WT/LNK 0101CF40 






P/P STORAGE BOUNDARIES 0006E800 TO 00080000 










FREE AREAS SIZE 










06EB90 00000060 
06EC50 00000050 
06F5B8 0000FC58 
07F668 C0000098 
07F7D8 00000010 
07F840 00000228 
07FB90 OOOOOOCO 
07FEE8 0000C018 










GOTTEN CORE SIZE 










Q7F210 OOOC0380 
06F310 COOO02A8 
CTfCSO 00000068 
C6F228 00000068 
07F590 00000008 
07FSF0 C0000008 
C7F018 00000098 
07F7O0 O0O0CO60 
O7FT60 00000078 
07FA68 00000060 
0TFAC8 00000078 



















Figure 16. Sample of an ABEND Dump (MFT) (Part 1 of 2) 
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SAVE AREA TRACE 



PAGE 0002 



TATH810G WAS ENTERED 



WD1 0606EAC8 
Rl 0001CC80 
R7 0007FC30 



HSA 00000100 
R2 00000000 
R8 0006ECEO 



LSA 0006EE60 
R3 00080000 
R9 0007FF78 



RET 00009848 
R4 0007FE48 
RIO 0007FFB0 



EPA 4006EE48 
R5 00000098 
Rll 0007FFF8 



RO 000098CE 
R6 000055D8 
R12 4006ECCE 



W01 00000000 
Rl 00000000 
R7 00000000 



HSA 0006EBF8 
R2 00000000 
R8 00000000 



LSA 00000000 
R3 00000000 
R9 00000000 



RET 00000000 
R4 00000000 
RIO 00000000 



EPA 00000000 
R5 00000000 
Rll 00000000 



RO 00000000 
R6 00000000 
R12 00000000 



PROCEEDING BACK VIA REG 13 



SA 06EE60 


WD1 

Rl 

R7 


00000000 
00000000 
00000000 


HSA 

R2 

R8 


0006EBF8 
00000000 
00000000 


LSA 00000000 
R3 00000000 
R9 00000000 


RET 00000000 
R4 00000000 
RIO 00000000 


EPA 

R5 

Rll 


00000000 
00000000 
00000000 


RO 
R6 
R12 


00000000 
00000000 
00000000 


TATHB10G WAS 


ENTERED 


















SA 06EBF8 


WD1 

Rl 

R7 


0606 EAC 8 
0001CC80 
0007FC30 


HSA 

R2 

R8 


00000100 
00000000 
0006ECEO 


LSA 0006EE60 
R3 00080000 
R9 0007FF78 


RET 00009848 
R4 0007FE48 
RIO 0007FFBO 


EPA 

R5 

Rll 


4006EE48 
00000098 
0007FFF8 


RO 
R6 
R12 


00009 8CE 
000055D8 
4006ECCE 


DATA SETS 






















SNAP2 


UCB 


192 


00225C 


OEB 


07F78C 


DCB 06EFB4 










DUMDCB 


UCB 


192 


00225C 


DE8 


07FAF4 


DCB 06EF5C 










JOBLIB 


UCB 


190 


00218C 
















SYSPRINT 


UCB 


192 


00225C 
















SVSABEND 


UCB 


192 


00225C 
















SNAP1 


UCB 


190 


00218C 

















REGS AT ENTRY TO ABEND 

FL.PT.REGS 0-6 00.000000 00000000 



00.000000 00000000 



00.000000 00000000 



00.000000 00000000 



REGS 0-7 




REGS 8-15 


NUCLEUS 




000000 


OOOCOOOO 


000020 


0004000A 


000040 


1007F5E8 


000060 


00040000 


000080 


000153B0 


OOOOAO 


00000000 


LINES 


OOOOCi 


000160 


00000000 


000180 


0001CB20 


0001AO 


00000000 


LINE 


0001C0 


0001E0 


000079FO 


000200 


0000846C 


000220 


00013340 


000 240 


40100038 


000 260 


02070440 


000280 


04409C29 


0002AO 


90A19030 


0002C0 


9180001B 


0002E0 


01A098CD 


000 300 


000012AA 


000320 


07BB50F0 



000002AO 
0006EE60 



8000007B 
0007FF78 



00000000 
0007FFB0 



00080000 
0007FFF8 



0007FE48 
4006EE4E 



00000098 
0006EE60 



00005508 
00009848 



0007FC30 
00000000 



0000051C F0F0F5C1 00000000 

50006B46 00000000 00000000 

50000000 00001480 000097F8 

0000033A 00040000 000002DE 

00000000 00000000 00000000 

00000000 00000000 00000000 
0-000140 SAME AS ABOVE 

00000000 00000000 82000170 

00007E91 0006F465 80007D16 

00000000 00000000 00000000 

SAME AS ABOVE 

000068B8 0000A43A 00000001 

000083E4 00006780 00006942 

00234700 024C96FO 02279029 

94FD4011 90A13030 5890021C 

003847F0 024C940F 02279829 

018091F0 023B4780 029C90A1 

58990000 D2079010 001894FD 

478002CE 58200208 052247F0 

002858B0 02189101 0029078B 

47C00332 90C2B004 181B5880 

002C41E0 02DC98AD 01A08200 



000097F8 00013440 01040080 8003AC04 
OOOOFFOO 00000000 FF04000E A0007E2A 
60C85DC0 00000000 00040000 00000282 
00000000 0000B278 00040000 00000226 
00000000 00000000 00000000 00000000 
00000000 00000000 OOOOOOOO 00000000 

00040000 0003A7A0 OOOOOOOO OOOOOOOO 
00000080 0006F491 00000001 0006F4A8 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 

40007720 0000A042 90001520 OOOOOOOO 
00001000 00000F28 00009730 0001335C 
01805830 06C45840 30004700 025CD207 
05B95850 02105890 021407F9 90A101E0 
018O91F0 023B4780 044898A1 01E08200 
01E0D207 04400018 47F002B2 589006C4 
90119140 001B4780 02C05820 02040522 
026AO0O0 000153B8 000087DA 0A0390A9 
58A006C4 58A0A004 12AA07CB 18BA58AA 
02189280 100098F0 A0008900 C0001200 
00281 81B 58800218 07FB900F 04005890 



.005A.......8 M* 






































































































































































































































































Figure 16. Sample of an ABEND Dump (MFT) (Part 2 of 2) 
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Device and Space Considerations : DD 
statements for ABEND/SNAP dumps, must 
contain parameters appropriate for a basic 
sequential (BSAM) data set. Data sets can 
be allocated to any device supported by the 
basic sequential access method. There are 
several ways to code these DD statements 
depending on what type of device you choose 
and when you want the dump printed. 



If you wish to have the dump printed 
immediately, code a DD statement defining a 
printer data set. 

r 1 

|//SYSABEND DD UNIT=1443,DCB=(. . . j 

L I 

A printer is associated with the SYSOUT 
class,, you can also obtain immediate 
printing by routing the data set through 
the output stream. 



|//SNAPDUMP DD SYSOUT=A,DCB=(... . 

L 



— 1 



This type of request is the easiest, 
most economical way to provide for a dump. 
All other DD statements result in the tying 
up of an output unit or delayed printing of 
the dump. 

If you wish to retain the dump, you can 
keep or catalog it on a direct access or 
tape unit. The last step in the pertinent 
job can serve several functions: to print 
out key data sets in steps that have been 
abnormally terminated, to print' an ABEND or 
SNAP dump stored in an earlier step, or to 
release a tape volume or direct access 
space acquired for dump data sets. 
Conditional execution of the last step can 
be established through proper use of the 
COND parameter and its subparameters, EVEN 
and ONLY, on the EXEC statement. 



Direct access space should be requested 
in units of average block size rather than 
in cylinders (CYL) or tracks (TRK) . If 
abnormal termination occurs and the data 
set is retained, the tape volume or direct 
access space should be released (DELETE in 
the DISP parameter) at the time the data 
set is printed. 

Sample DD Statements : Figure 17 shows a 
set of job steps that include DD statements 
for ABEND dump data sets. 

The SYSABEND DD statement in STEP2 takes 
advantage of the direct access space 
acquired in STEP1 by indicating MOD in the 
DISP parameter. Note that the space 
request in STEP1 is large so that the 
dumping operation is not inhibited due to 
insufficient space. The final SYSABEND DD 
statement in the job should indicate a 
disposition of DELETE to free the space 
acquired for dumping. 

Contents of an ABEND/SNAP Dump (MFT) 

This explanation of the contents of 
ABEND/SNAP dumps for systems with MFT is 
interspersed with sample sections taken 
from an ABEND dump. Capital letters 
represent the headings found in all dumps, 
and lowercase letters, information that 
varies with each dump. The lowercase 
letter used indicates the mode of the 
information, and the number of letters 
indicates its length: 

• h represents 1/2 byte of hexadecimal 
information 

• d represents 1 byte of decimal 
information 

• c represents a 1-byte character 

You may prefer to follow the explanation 
on your own ABEND or SNAP dump. 
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■//,step/ 


EXEC 


PfiWsP 


ROGRA 


Ml 






















■//SYSABEI 


10 00 


OS NAM 


E-OUM 


P,UNI 


T=23l 


',OiS 


P=(>K 


EEP,K 


EEPh 








X 




■// 




VOL l/M 


E-SER 


= I23«* 


,SPAC 


E«(TR 


K>(M 


0,10) 


) 










































^^^^H otK< 


llr OD i 


.t&teti 


ents 






















































■//STEP2 


EXEC 


PGM=P 


ROGRA 


M2 






















■//SYSABEI 


ID DD 


OS NAM 


E**.S 


TEPI. 


SYSAB 


END,D 


ISP*( 


MOD.D 


ELETE 


,KEEP 


), 




X 




■// 




VOL*R 


EF«*. 


STEP/ 


.SYSABEND 























































































































































































































































Figure 17. SYSABEND DD Statements 
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***ABDUMP REQUESTED*** 






♦ccccccc ... 






JOB cccccccc STEP cccceccc TIME dddddd 


DATE ddddd 


PAGE dddd 


COMPLETION CODE SYSTEM - hhh (or USER - dddd) 






cccccc ... 






INTERRUPT AT hhhhhh 






PSW AT ENTRY TO ABEND (SNAP) hhhhhhhh hhhhhhhh 







***ABDUMP REQ U E S T E D * * * 
identifies the dump as an ABEND or 
SNAP dump. 



♦ccccccc ..... 

is omitted or is one or more of the 
following : 

♦CORE NOT AVAILABLE, LOG. 

hhhhhhhhhhhh TAKEN... 

indicates that the ABDUMP routine 
confiscated storage locations 
hhhhhh through hhhhhh because not 
enough storage was available. 
This area is printed under P/P 
STORAGE, but can be ignored 
because the problem program 
originally in it was overlaid 
during the dumping process. 

♦MODIFIED, /SIRB/DEB/LLS/ARB/MSS . . . 
indicates that the one or more 
queues listed were destroyed or 
their elements dequeued during 
abnormal termination: 

• SIRB — system interruption 
request block queue. One or 
more SIRB elements were found 
in the active RB queue: these 
elements are always dequeued 
during dumping. 

• DEB — DEB queue. If the first 
message also appeared, either a 
DEB or an associated DCB was 
overlaid. 

• LLS — load list. If the first 
message also appeared, one or 
more loaded RBs were overlaid. 

• ARB — active RB queue. If the 
first message also appeared, 
one or more RBs were overlaid. 

• MSS — boundary box queue. One 
or more MSS elements were 
dequeued, but an otherwise 
valid control block was found 



in the free area specified by 
an MSS element. 

♦FOUND ERROR IN /DEB/LLS/ARB/MSS . . . 

indicates that one or more of the 
following contained an error: 

• DEB: data extent block 

• LLS: load list 

• ARB: active RB 

• MSS: boundary box 

This message appears with either 
the first or second message 
above. The error could be: 
improper boundary alignment, 
control block not within storage 
assigned to the program being 
dumped, or an infinite loop (300 
times is the maximum for this 
test) . For an MSS block, 4 other 
errors could also be found: 
incorrect descending sequence 
(omitting loop count) , 
overlapping free areas, free area 
not entirely within the storage 
assigned to the program being 
dumped, or count in count field 
not a multiple of 8. 

JOB cccccccc 

is the job name specified in the JOB 
statement. 

STEP cccccccc 

is the step name specified in the EXEC 
statement for the problem program 
being dumped. 

TIME dddddd 

is the hour (first 2 digits) , minute 
(second 2 digits) , and second (last 2 
digits) when the ABDUMP routine began 
processing. 

DATE ddddd 

is the year (first 2 digits) and day 
of the year (last 3 digits). For 
example, 67352 would be December 18, 
1967. 
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PAGE dddd 

is the page number, 
top of each page. 



Appears at the 



COMPLETION CODE SYSTEM=hhh or COMPLETION 

CODE USER=dddd 

is the completion code supplied by the 
control program (SYSTEM=hhh) or the 
problem program (USER=dddd). Either 
SYSTEM=hhh or USER=dddd is printed, 
but not both. Common completion codes 
are explained in Appendix B. 

cccccc 

explains the completion code or, if a 
program interruption occurred: 
PROGRAM INTERRUPTION ccccc... AT 
LOCATION hhhhhh, 

where ccccc is the program 
interruption cause — OPERATION, 
PRIVILEGED OPERATION, EXECUTE, 
PROTECTION, ADDRESSING, SPECIFICATION, 
DATE,, FIXED-POINT OVERFLOW, 



FIXED-POINT DIVIDE, DECIMAL OVERFLOW, 
DECIMAL DIVIDE, EXPONENT 
OVERFLOW, EXPONENT UNDERFLOW, 
SIGNIFICANCE, or FLOATING-POINT 
DIVIDE; and hhhhhh is the starting 
address of the instruction being 
executed when the interruption 
occurred. 



INTERRUPT AT hhhhhh 

is the address of next instruction to 
be executed in the problem program. 
It is obtained from the resume PSW of 
the PRB or LPRB in the active RB queue 
at the time abnormal termination was 
requested. 

PSW AT ENTRY TO ABEND hhhhhhhh hhhhhhhh or 
PSW AT ENTRY TO SNAP hhhhhhhh hhhhhhhh 

is the PSW for the problem or control 
program that had control when abnormal 
termination was requested or when the 
SNAP macro instruction was executed. 



TCB 


hhhhhh RB 


hhhhhhhh PIE hhhhhhhh 


DEB hhhhhhhh TIOT 


hhhhhhhh 


CMP hhhhhhhh 


TRN hhhhhhhh 




MSS 


hhhhhhhh PK/FLG hhhhhhhh 


FLG hhhhhhhh LLS 


hhhhhhhh 


JLB hhhhhhhh 


JST hhhhhhhh 




RG 0- 


-7 hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 




RG 8- 


-15 hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 




FSA 


hhhhhhhh TCB hhhhhhhh 


TME hhhhhhhh PIB 


hhhhhhhh 


NTC hhhhhhhh 


OTC hhhhhhhh 




LTC 


hhhhhhhh IQE hhhhhhhh 


ECB hhhhhhhh XTCB 


hhhhhhhh 


LP/FL hhhhhhhh 


RESV hhhhhhhh 




STAE 


hhhhhhhh TCT hhhhhhhh 


USER hhhhhhhh DAR 


hhhhhhhh 


RESV hhhhhhhh 


JSCB hhhhhhhh 



TCB hhhhhh 

is the starting address of the TCB. 

RB hhhhhhhh 

is the TCBRBP field (bytes through 
3): starting address of the active RB 
queue and, consequently, the most 
recent RB on the queue (usually 
ABEND'S RB). 

PIE hhhhhhhh 

is the TCBPIE field (bytes 4 through 
7) : starting address of the program 
interruption element (PIE) for the 
task. 

DEB hhhhhhhh 

is the TCBDEB field (bytes 8 through 
11) : starting address of the DEB 
queue. 

TIOT hhhhhhhh 

is the TCBTIO field (bytes 12 through 
15) : starting address of the TIOT. 

CMP hhhhhhhh 

is the TCBCMP field (bytes 16 through 
19) : task completion code in 



hexadecimal. System codes are shown 
in the third through fifth digits and 
user codes in the sixth through 
eighth. 



TRN hhhhhhhh 

is the TCBTRN field (bytes 20 through 
23): starting address of control core 
(table) for controlling testing of the 
task by TESTRAN. 



MSS hhhhhhhh 

is the TCBMSS field (bytes 24 through 
27): starting address of the main 
storage supervisor's boundary box. 



PK/FLG hhhhhhhh 

contains, in the first 2 digits, the 
TCBPKF field (byte 28) : protection 
key. 

FLG hhhhhhhh 

contains, in the first 4 digits, the 
last 2 bytes of the TCBFLGS field 
(bytes 32 and 33): last 2 flag bytes 
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contains,, in the next 2 digits, the 
TCBLMP field (byte 34): number of 
resources on which the task is queued. 



contains, in the last 2 digits, the 
TCBDSP field (byte 35) : 



Reserved in MFT without subtasking; 
both digits are zero. 

In MFT with subtasking, this field 
contains the dispatching priority of 
the TCB. 



TME hhhhhhhh 

is the TCBTME field (bytes 120 through 
123): starting address of the timer 
element created when an STIMER macro 
instruction is issued by the task. 
This field is not printed if the 
computer does not contain the timer 
option. 



PIB hhhhhhhh 

is the TCBPIB field (bytes 124 through 
127): starting address of the program 
information block. 



LLS hhhhhhhh 

is the TCBLLS field (bytes 36 through 
39) : starting address of the RB 
most recently added to the load 
list. 



JLB hhhhhhhh 

is the TCB JLB field (bytes 40 through 
43) : starting address of the DCB 
for the JOBLIB data set. 



NTC hhhhhhhh 

is the TCBNTC field (bytes 128 through 
131): 

MFT without subtasking: zeros. 

MFT with subtasking: the starting 
address of the TCB for the previous 
sub task on this subtask TCB queue. 
This field is zero both in the job 
step task, and in the TCB for the 
first subtask created by a parent 
task. 



JST hhhhhhh 

is the TCB JST field (bytes 44 through 
47). Not currently used in MFT 
without subtasking. In MFT with 
subtasking - the starting address of 
the TCB for the job step task. 



OTC hhhhhhhh 

is the TCBOTC field (bytes 132 through 
135): starting address of the TCB for 
the parent task. Both in the TCB for 
the job step task, and in MFT systems 
without subtasking this field is zero. 



RG 0-7 and RG 8-15 

is the TCBGRS field (bytes 48 through 
111) : contents of general registers 
through 7 and 8 through 15, as stored 
in the save area of the TCB when a 
task switch occurred. These 2 lines 
appear only in TCBs of tasks other 
than the task in control when the dump 
was requested. 



FSA hhhhhhhh 

contains, in the first 2 digits, the 
TCBIDF field (byte 112): TCB 
identifier field. 



LTC hhhhhhhh 

is the TCBLTC field (bytes 136 through 
139): starting address of the TCB for 
the most recent subtask created by 
this task. This field is zero in the 
TCB for the last subtask of a job 
step, or in the TCB for a task that 
does not create subtasks. This field 
is always zero in an MFT system 
without subtasking . 



IQE hhhhhhhh 

is the TCBIQE field (bytes 140 through 



143). 



contains, in the last 6 digits, the 
TCBFSA field (bytes 113 through 115): 
starting address of the first problem 
program save area.. This save area was 
set up by the control program when the 
job step was initiated. 



TCB hhhhhhhh 

is the TCBTCB field (bytes 116 through 
119): starting address of the next 
TCB of lower priority or, if this is 
the last TCB,, zeros. 



MFT without subtasking: zero. 

MFT with subtasking: starting address 
of the interruption queue element 
(IQE) for the ETXR exit routine. This 
routine is specified by the ETXR 
operand of the ATTACH macro 
instruction that created the TCB being 
dumped. The routine is to be entered 
when the task terminates. 

ECB hhhhhhhh 

is the TCBECB field (bytes 144 through 
147), 
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MFT without subtasking: zero. 

MFT with subtasking: starting address 
of the ECB field to be posted by the 
control program at task termination. 
This field is zero if the task was 
attached without an ECB operand. 

XTCB hhhhhhhh 

reserved for future use. 



TCT hhhhhhhh 

is the TCBTCT field (bytes 164 through 
167): 



Address of the Timing Control Table 
(TCT): zeros if the System Management 
Facilities option is not present in 
the system. 



LP/FL hhhhhhhh 

MFT without subtasking: 



reserved. 



MFT with subtasking: contains in the 
first byte, the limit priority of the 
task (byte 152). contains, in the 
last three bytes the field TCBFTFLG 
(bytes 153 through 155) - flag bytes. 

RESV hhhhhhhh 

reserved for future use. 

STAE hhhhhhhh 

contains, in the first 2 digits, STAE 
flags (byte 160). 

contains, in the last 6 digits, the 
TCBNSTAE field (bytes 161 through 
163) : starting address of the current 
STAE control block for the task. This 
field is zero if STAE has not been 
issued. 



USER hhhhhhhh 

is the TCBUSER field (bytes 168 
through 171): to be used as the user 
chooses. 

DAR hhhhhhhh 

contains, in the first 2 digits. 
Damage Assessment Routine (DAR) flags 
(byte 172); 

contains, in the last 6 digits, the 
secondary non-dispatchability bits 
(bytes 173 through 175) . 

RESV hhhhhhhh 

reserved for future use. 

JSCB hhhhhhhh 

is the TCBJSCB field (bytes 180 
through 183): the last three bytes 
contain the address of the Job Step 
Control Block. 



ACTIVE RBS 












cccc hhhhhh 


NM 


cccccccc SZ/STAB hhhhhhhh 


USE/EP hhhhhhhh PSW 


hhhhhhhh hhhhhhhh Q 


hhhhhh WT/LNK hhhhhhhh 




RG 


0-7 hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 




RG 


8-15 hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 



ACTIVE RBS 

identifies the next lines as the 
contents of the active RBs queued to 
the TCB. 

cccc hhhhhh 

indicates the RB type and its starting 
address. 

The RB types are: 

PRB Program request block 

SIRB supervisor interrupt request 
block 

LPRB Loaded program request block 

IRB Interruption request block 

SVRB Supervisor request block 



Note: 



Three SVRBs for ABEND 



processing exist in the nucleus. They 
are used when there is insufficient 
space in the partition to create an 
SVRB. 



NM xxxxxxxx 

is the XRBNM field (bytes through 
7): in PRB, LRB, and LPRB, the 
program name; in IRB, the first byte 
contains flags for the timer or, if 
the timer is not being used, contains 
no meaningful information; in SVRB for 
a type 2 SVC routine, the first 4 
bytes contain the TTR of the load 
module in the SVC library, and the 
last 4 bytes contain the SVC number in 
signed, unpacked decimal. 
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SZ/STAB hhhhhhhh 

contains in the first 4 digits, the 
XRBSZ field (bytes 8 and 9) : number 
of contiguous doublewords in the RB f 
the program (if applicable), and 
associated supervisor work areas. 

contains in the last 4 digits, the 
XSTAB field (bytes 10 and 11) : flag 
bytes. 

USE/EP hhhhhhhh 

contains, in the first 2 digits, the 
XRBUSE field (byte 12) : use count. 

contains > in the last 6 digits, the 
XRBEP field (bytes 13 through 15): 
address of entry point in the 
associated program. 

PSW hhhhhhhh hhhhhhhh 

is the XRBPSW field (bytes 16 through 
23) : resume PSW. 

Q hhhhhh 

is the last 3 bytes of the XRBQ field 



(bytes 25 through 27) : in PRB and 
LPRB, starting address of ah LPRB for 
an entry identified by an IDENTIFY 
macro instruction; in IRB, starting 
address of a request element; in SVRB 
for a type 3 or 1 SVC, size of the 
program in bytes. 

WT/LNK hhhhhhhh 

contains, in the first 2 digits, the 
XRBWT field (byte 28) : wait count. 

contains, in the last 6 digits, the 
XRBLNK field (bytes 29 through 31): 
primary queuing field. It is the 
starting address of the previous RB 
for the task or, in the first RB to be 
placed on the queue, the starting 
address of the TCB. 

RG 0-7 and RG 8-15 

is the XRBREB field (bytes 32 through 
95 in IRBs and SVRBs) : contents of 
general registers through 15 stored 
in the RB. These 2 lines do not 
appear for PRBs, LPRBs, and LRBs. 



LOAD LIST 

cccc hhhhhh NM cccccccc SZ/STAB hhhhhhhh USE/EP hhhhhhhh PSW hhhhhhhh hhhhhhhh Q hhhhhh WT/LNK hhhhhhhh 



LOAD LIST 

identifies the next lines as the 
contents of the load list queued to 
the TCB. 



cccc hhhhhh 

indicates the RB type and its starting 
address. 

The RB types are: 

LRB Loaded request block 
LPRB Loaded program request block 
D-LPRB Dummy loaded program request 
block. (Present if the 
resident reenterable load 
module option was selected). 

NM cccccccc 

is the XRBNM field (bytes through 
7) : program name. 

SZ/STAB hhhhhhhh 

contains, in the first 4 digits, the 
XRBSZ field (bytes 8 and 9) : number 
of contiguous doublewords for the RB, 
the program (if applicable) , and 
associated supervisor work areas. 



contains, in the last 4 digits, the 
XSTAB field (bytes 10 and 11) : flag 
bytes . 

USE/EP hhhhhhhh 

contains, in the first 2 digits, the 
XRBUSE field (byte 12): use count. 

contains, in the last 6 digits, the 
XRBEP field (bytes 12 through 15) : 
address of entry point in the program. 

PSW hhhhhhhh hhhhhhhh 

is the XRBPSW field (bytes 16 through 
23): resume PSW. 

Q hhhhhh 

is the last 3 bytes of the XRBQ field 
(bytes 25 through 27) : in LPRB, 
starting address of an LPRB for an 
entry identified by an IDENTIFY macro 
instruction; in LRB, unused. 

WT/LNK hhhhhhhh 

contains, in the first 2 digits, the 
XRBWT field (byte 28) : wait count. 

contains, in the last 6 digits, the 
XRBLNK field (bytes 29 through 31): 
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primary queuing field for LRBs and 
LPRBs also on the active RB queue.. It 
points to the previous RB for the task 
or, in the oldest RB in the queue, 
back to the TCB. 



JOB PACK AREA QUEUE 

cccc hhhhhh NM cccccccc 
cccc hhhhhh NM cccccccc 
cccc hhhhhh NM cccccccc 


SZ/STAB 
SZ/STAB 
SZ/STAB 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


USE/EP 

WTL 

USE/EP 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


PSW 
REQ 
PSW 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


hhhhhhhh Q hhhhhh 

TLPRB hhhhhhhh 
hhhhhhhh Q hhhhhh 


WT/LNK 
WT/LNK 


hhhhhhhh 
hhhhhhhh 



JOB PACK AREA QUEUE (MFT with subtasking 

only) 

identifies the next lines as the 
contents of the job pack area queue 
originating in the partition 
information block (PIB). 

cccc hhhhhh 

indicates the RB type and its starting 
address. 

The RB types are: 

FRB Finch request block 

LRB Loaded request block 

LPRB Loaded program request block 

NM cccccccc 

is the XRBNM field (bytes through 
7) : Program name. 

SZ/STAB hhhhhhhh 

contains, in the first M digits, the 
XRBSZ field (bytes 8 and 9) : number 
of contiguous doublewords for the RB, 
the program (if applicable), and 
associated supervisor work areas. 

contains, in the last 4 digits, the 
XSTAB field (bytes 10 and 11) : flag 
bytes. 

USE/EP hhhhhhhh (LPRB, LRB Only) 

contains, in the first 2 digits, the 
XRBUSE field (byte 12) : use count. 

contains, in the last 6 digits, the 
XRBEP field (bytes 13 through 15): 
address of entry point in the program. 

WTL hhhhhhhh (FRB Only) 

is the XRWTL field of the FRB (bytes 



12 through 15) : address 
recent wait list element 
WLE queue. 



of the most 
(WLE) on the 



PSW hhhhhhhh hhhhhhhh (LPRB, LRB Only) 

is the XRBPSW field (bytes 16 through 
23): resume PSW. 



REQ hhhhhhhh (FRB Only) 

is the XRREQ field of the FRB (bytes 
16 through 19): address of the TCB of 
the requesting task. 

TLPRB hhhhhhhh (FRB Only) 

is the XRTLPRB field of the FRB (bytes 
20 through 23) : address of the LPRB 
built by the Finch routine for the 
requested program. 

Q hhhhhh (LRB, LPRB Only) 

is the last 3 bytes of the XRBQ field 
(bytes 25 through 27) : 

• in an LPRB, the starting address ~of 
an LPRB for an entry identified by 
an IDENTIFY macro instruction. 

• in an LRB, unused. 

WT/LNK hhhhhhhh (LRB, LPRB Only) 

contains, in the first 2 digits, the 
XRBWT field (byte 28) : wait count. 

contains, in the last 6 digits (bytes 
29 through 31) : primary queuing field 
for RBs. These RBs may be queued 
either on the job pack area queue or 
on the active RB queue. It points to 
the previous RB for the task or, in 
the oldest RB on the queue, back to 
the TCB. 
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P/P STORAGE 


BOUNDARIES hhhhhhhh TO hhhhhhhh 










FREE AREAS 


SIZE 












hhhhhh 


hhhhhhhh 












GOTTEN CORE 


SIZE 












hhhhhh 


hhhhhhhh 












SAVE AREA TRACE 












cccccccc WAS 


ENTERED VIA LINK (CALL) ddddd AT EP ccccc. 










SA hhhhhh 


WD1 hhhhhhhh 


HSA hhhhhhhh LSA hhhhhhhh 


RET hhhhhhhh 


EPA hhhhhhhh 


RO 


hhhhhhhh 




Rl hhhhhhhh 


R2 hhhhhhhh R3 hhhhhhhh 


R4 hhhhhhhh 


R5 hhhhhhhh 


R6 


hhhhhhhh 




R7 hhhhhhhh 


R8 hhhhhhhh R9 hhhhhhhh 


RIO hhhhhhhh 


Rll hhhhhhhh 


R12 


hhhhhhhh 


INCORRECT BACK CHAIN 












PROCEEDING BACK VIA REG 13 













P/P STORAGE BOUNDARIES hhhhhhhh TO hhhhhhhh 
gives the addresses of the lower and 
upper boundaries of a main storage 
area assigned to the task. This 
heading is repeated for every 
noncontiguous block of storage owned 
by the task. 

FREE AREAS SIZE 

hhhhhh hhhhhh 



cccccccc WAS ENTERED 

is the name of the program that stored 
register contents in the save area. 
This name is obtained from the RB. 



VIA LINK (CALL) ddddd 

indicates the macro instruction (LINK 
or CALL) used to give control to the 
next lower level module, and is the ID 
operand, if it was specified, of the 
LINK or CALL macro instruction. 



hhhhhh hhhhhh 

are the starting addresses of free 
areas and the size, in bytes, of each 
area contained within the P/P STORAGE 
BOUNDARIES field listed above. 

GOTTEN CORE SIZE 

hhhhhh hhhhhhhh 



hhhhhh hhhhhhhh 

(Printed only in a dump of a system 
with the MFT with subtasking option) . 
These figures represent the starting 
addresses of the gotten areas (those 
areas obtained for a subtask through a 
supervisor issued GETMAIN macro 
instruction), and the size, in bytes, 
of each area contained within the P/P 
STORAGE BOUNDARIES field listed above. 
If main storage hierarchy support is 
included in the system, the values in 
this field can address storage in 
either hierarchy or hierarchy 1, or 
both, 

SAVE AREA TRACE 

identifies the next lines as a trace 
of the save areas for the program. 



AT EP ccccc ... 

is the entry point identified, which 
appears only if it was specified in 
the SAVE macro instruction that filled 
the save area. 

SA hhhhhh 

is the starting address of the save 
area. 

WD1 hhhhhhhh 

is the first word of the save area: 
use of this word is optional. 

HSA hhhhhhhh 

is the second word of the save area: 
starting address of the save area in 
the next higher level module. In the 
first save area in a job step, this 
word contains zeros. In all other 
save areas, this word must be filled. 

LSA hhhhhhhh 

is the third word of the save area 
(register 13) : starting address of 
the save area in the next lower level 
module. 

RET hhhhhhhh 

is the fourth word of the save area 
(register 14): return address. 
Optional. 



40 Programmer^ Guide to Debugging (Release 21) 



EPA hhhhhhhh 

is the fifth word of the save area 
(register 15) : entry point to the 
invoked module. Optional. 

RO hhhhhhhh Rl hhhhhhhh ... R12 hhhhhhhh 
are words 6 through 18 of the save 
area (registers through 12) : 
contents of registers through 12 
immediately after the linkage for the 
module containing the save area. 

INCORRECT BACK CHAIN 

indicates that the following lines may 
not be a save area because the second 



word in this area does not point back 
to the previous save area in the 
chain. 



PROCEEDING BACK VIA REG 13 

indicates that the next 2 save areas 
are (1) the save area in the lowest 
level module, followed by (2) the save 
area in the next higher level module. 
The lowest save area is assumed to be 
the save area pointed to by register 
13. These 2 save areas appear only if 
register 13 points to a full word 
boundary and does not contain zeros. 



DATA SETS 






***** NOT FORMATTED ***** 






cccccccc UCB ddd hhhhhh 


DEB hhhhhh 


DCB hhhhhh 


**D/S FORMATTING TERMINATED** 







DATA SETS 

indicates that the next lines present 
information about the data sets for 
the task. For unopened data sets, 
only the ddname and UCB information 
are printed. 

NOT FORMATTED 

indicates that the abnormal 
termination dump routine confiscated 
storage (indicated by *CORE NOT 
AVAILABLE, LOC. hhhhhh-hhhhhh TAKEN); 
because DCBs may have been overlaid, 
or that the dump is for an OLTEP task. 
Data set information is not presented. 

cccccccc 

is the name field (ddname) of the DD 
statement. 

UCB ddd hhhhhh 

is the unit to which the data set was 



assigned, and the starting address of 
the UCB for that unit. If the data 
set was assigned to several units, the 
additional units are identified on 
following lines. 



DEB hhhhhh 

is the starting address of the DEB for 
the data set. Appears only for open 
data sets . 

DCB hhhhhh 

is the starting address of the DCB for 
the data set. Appears only for open 
data sets . 

**D/S FORMATTING TERMINATED** 

indicates that no more data set 
information is presented because a DCB 
is incorrect, possibly because a 
program incorrectly modified it. 
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TRACE TABLE - STARTING WITH OLDEST ENTRY 

dddd I/O ddd PSW hhhhhhhh hhhhhhhh 

dddd SIO ddd CC * d 

dddd SVC ddd PSW hhhhhhhh hhhhhhhh 



CSW hhhhhhhh hhhhhhhh 
CAW hhhhhhhh OLD CSW hhhhhhhh hhhhhhhh (or CSW STATUS hhhh) 
RG hhhhhhhh RG 1 hhhhhhhh 



TRACE TABLE — STARTING WITH OLDEST ENTRY 
identifies the next lines as the 
contents of the trace table. Each 
entry is presented on one line. The 
types of entries are: 



I/O Input/output interruption entry 



SIO start input/output (SIO) entry 

SVC supervisor call (SVC) interruption 
entry 



dddd 



is the number assigned to each entry. 
The oldest entry receives the number 
0001,. 



CC=d 

is the condition code resulting from 
execution of the SIO instruction. 
Zero indicates a successful start. 

CAW hhhhhhhh 

is the channel address word used by 
the SIO instruction. 

OLD CSW hhhhhhhh hhhhhhhh 

is the channel status word stored 
during execution of an SIO operation. 
It appears when CC is not equal to 1. 

CSW STATUS hhhh 

is the status portion of the channel 
status word stored during execution of 
an SIO instruction. Appears when CC 
is equal to 1. 



I/O ddd 

is the channel and unit that caused 
the input/output interruption. 



PSW hhhhhhhh hhhhhhhh 

is the program status word that was 
stored when the input/output 
interruption occurred. 

CSW hhhhhhhh hhhhhhhh 

is the channel status word that was 
stored when the input/output 
interruption occurred. 

SIO ddd 

is the device specified in the SIO 
instruction. 



SVC ddd 

is the SVC instruction's operand. 



PSW hhhhhhhh hhhhhhhh 

is the PSW stored during the SVC 
interruption. An F in the fifth digit 
of the first word identifies the entry 
as representing a task switch. 



RG hhhhhhhh 

is the contents of register 
passed to the SVC routine. 



as 



RG 1 hhhhhhhh 

is the contents of register 1 as 
passed to the SVC routine. 
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REGS 


AT ENTRY TO ABEND (SNAP) 








FLTR 


0-6 hhhhhhhhhhhhhhhh 


hhhhhhhhhhhhhhhh 


hhhhhhhhhhhhhhhh 


hhhhhhhhhhhhhhhh 


REGS 


0-7 hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


REGS 


8-15 hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 



REGS AT ENTRY TO ABEND or REGS AT ENTRY TO FLTR 0-6 

SNAP 

identifies the next 3 lines as the 

contents of the floating point and 

general registers when the abnormal REGS 0-7 

termination routine received control 

in response to an ABEND macro 

instruction or when the SNAP routine 

received control in response to a SNAP REGS 

macro instruction. 



is the contents of floating point 
registers # 2, 4, and 6. 



is the contents of general registers 
through 7. 

8-15 

is the contents of general registers 8 

through 15. 



NUCLEUS 


















hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*cccccccccccccccccccccccccccccccc* 


hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


♦cccccccccccccccccccccccccccccccc* 


LINE 


hhhhhh SAME AS ABOVE 














hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*cccccccccccccccccccccccccccccccc* 


LINES 


hhhhhh-hhhhhh 


SAME AS ABOVE 












hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*cccccccccccccccccccccccccccccccc* 


P/P STORAGE 
















hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


♦cccccccccccccccccccccccccccccccc* 


hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*cccccccccccccccccccccccccccccccc* 


hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*cccccccccccccccccccccccccccccccc* 


LINES 


hhhhhh-hhhhhh 


SAME AS ABOVE 












hhhhhh 


hhhhhhhh hhhhhhhh 
END OF DUMP 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*cccccccccccccccccccccccccccccccc* 



The content of main storage is given 
under 2 headings: NUCLEUS and P/P STORAGE. 
Under these headings, the lines have the 
following format: 

• First entry: the address of the 
initial byte of main storage contents 
presented on the line. 

• Next 8 entries: 8 full words (32 
bytes) of main storage in hexadecimal. 

• Last entry (surrounded by asterisks): 
the same 8 full words of main storage 
in EBCDIC. Only A through Z, through 
9, and blanks are printed; a period is 
printed for anything else. An 
exception occurs in the printed lines 
representing the ABDUMP work area. The 
contents of the ABDUMP work area during 
the printing of EBCDIC characters 



differs from the contents during 
printing of the hexadecimal characters 
because a portion of the work area is 
used to write lines to the printer. 
This exception should not create any 
problems since the contents of the 
ABDUMP work area is of little use in 
debugging. 

The following lines may also appear: 

LINES hhhhhhhh-hhhhhhhh SAME AS ABOVE 
are the starting addresses of the 
first and last line of a group of 
lines that are identical to the line 
immediately preceding. 

LINE hhhhhh SAME AS ABOVE 

is the starting address of a line that 
is identical to the line immediately 
preceding. 
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NUCLEUS 

identifies the next lines as the 
contents of the control program 
nucleus,. 

P/P STORAGE 

identifies the next lines as the 
contents of the main storage area 
assigned to the task (problem 
program) „ 

END OF DUMP 

indicates that the dump or snapshot is 
completed . 



Load List and Job Pack Area Queue ; The 
load module that had control at the time of 
abnormal termination may not contain the 
instruction address pointed to by the 
resume PSW. In that case, look at the RBs 
on the load list and on the job pack area 
queue (MFT with subtasking) . Compare the 
instruction address with the entry points 
of each load module (shown in the last 3 
bytes of the field labeled USE/EP) . The 
module which contains the instruction 
pointed to by the resume PSW is the one in 
which abnormal termination occurred. The 
name of the load module is indicated in the 
field labeled NM. 



Guide to Using an ABEND/SNAP Dump (MFT) 



Cause of Abnormal Termination ; Evaluate 
the user (USER Decimal code) or system 
(SYSTEM=hex code) completion code using 
Appendix C or the publication Messages and 
Codes . 



Active RB Queue ; The first RB shown on the 
dump represents the oldest RB on the queue. 
The RB representing the load module that 
had control when the dump was taken is 
third from the bottom. The last RB 
represents the ABDUMP routine, and the 
second from last, the ABEND routine., The 
names of load modules represented in the 
active RB queue are given in the RB field 
labeled NM in the dump. Names of load 
modules in SVC routines are presented in 
the format; 



NM 



SVC-mnnn 



where m is the load module number (minus 1) 
in the routine and nnn is the signed 
decimal SVC number. The last two RBs on an 
ABEND/ SNAP dump will always be SVRBs with 
edited names SVC-105A (ABDUMP — SVC 51) and 



SVC-401C (ABEND — SVC 13). 



Resume PSW ; The resume PSW field is the 
fourth entry in the first line of each RB 
printout. It is identified by the 
subheading PSW. For debugging purposes, 
the resume PSW of the third RB from the 
bottom, on the dump, is most useful. The 
last three characters of the first word 
give the SVC number or the I/O device 
address, depending on which type of 
interruption caused the associated routine 
to lose control. It also provides the CPU 
state at the time of the interruption (bit 
15), the length of the last instruction 
executed in the program (bits 32,33), and 
the address of the next instruction to be 
executed (bytes 5-8) . 



Trace Table ; Entries in the trace table 
reflect SIO, I/O, and SVC interruptions and 
task switching. SIO entries can be used to 
locate the CCW (through the CAW) , which 
reflects the operation initiated by an SIO 
instruction. If the SIO operation was not 
successful, the CSW STATUS portion of the 
entry will show you why it failed. 

I/O entries reflect the I/O old PSW and 
the CSW that was stored when the 
interruption occurred. From the PSW, you 
can learn the address of the device on 
which the interrupti on occurred (bytes 2 
and 3), the CPU state at the time of 
interruption (bit 15) , and the instruction 
address where the interruption occurred 
(bytes 5-8). The CSW provides you with the 
unit status (byte 4) , the channel status 
(byte 5) f and the address of the previous 
CCW plus 8 (bytes 0-3). 

SVC entries provide the SVC old PSW and 
the contents of registers and 1. The PSW 
offers you the hexadecimal SVC number (bits 
20-31) , the CPU mode (bit 15) r and the 
address of the SVC instruction (bytes 5-8). 
The contents of registers and 1 are 
useful in that many system macro 
instructions use these registers for 
parameter information. Contents of 
registers and 1 for each SVC interruption 
are given in Appendix A. 

A task switch entry is similar to an SVC 
entry, except that words 3 and 4 of the 
entry contain the address of the TCBs for 
the "new" and "old" tasks being performed, 
respectively. The trace table entries for 
one particular task are contained between 
sets of two task switch entries. Word 3 of 
the beginning task switch entry and word 4 
of the ending task switch entry point to 
the TCB for that task. Task switch entries 
are identified by a fifth digit of 'F*. 

Notes ; If an ABEND macro instruction is 
issued by the system when a program check 
interruption causes abnormal termination, 
an SVC entry does not appear in the trace 
table, but is reflected in the PSW at entry 
to ABEND. 
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Dumps issued by systems with MFT contain Free Areas ; ABEND/SNAP dumps do not print 

only the last four characters of the module out areas of main storage that are 

name in the RB APSW field. You cannot available for allocation. Since the ABEND 

distinguish between IFGOxxxx and IGGOxxxx. routine uses some available main storage. 

After an SVC 19 has been issued, the OPEN the only way you can determine the amount 

where-to-go table should be checked for the of free storage available when abnormal 

module name. termination occurred is to re-create the 

situation and take a stand-alone dump. 
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ABEND/SNAP Pump (MVT) 



MVT dumps differ from PCP and MFT dumps in 
the addition of detailed main storage 
control information, the omission of a 
complete main storage dump, and the 
omission of a trace table in ABEND dumps. 
MVT dumps occur immediately after an 
abnormal termination, provided an ABEND or 
SNAP macro instruction was issued and 
proper dump data sets were defined. 
However, if a system failure has occurred 
and a SYS1.DUMP data set has been defined 
and is available, a full storage image dump 
is provided, as explained in the section 
headed "Storage Image Dump." 



With MVT's subtask creating capability, 
you may receive one or more partial dumps 
in addition to a complete dump of the task 
that caused abnormal termination,. A 
complete dump includes all control 
information associated with the terminating 
task and a printout of the load modules and 
subpools used by the task. A partial dump 
of a task related to the terminating task 
includes only control information. A 
partial dump is identified by either ID=001 
or ID=002 printed in the first line of the 
dump. Figure 18 shows the key areas of a 
complete dump. 



In systems with MVT, you can effect 
termination of a job step task upon 
abnormal termination of a lower level task- 
To do this, you must either terminate each 
task upon finding an abnormal termination 
completion code issued by its subtask or 
pass the completion code on to the next 
higher level task. 

For a discussion of a formatted ABEND 
dump using the telecommunications access 
method (TCAM) in an MVT environment, see 
IBM System/360 Operating System: TCAM 
Program Logic Manual , GY30-2029. 
References to other TCAM debugging aids are 
found in Appendix J. 



Invoking an ABEND/ SNAP Dump (MVT) 

ABEND/SNAP dumps issued by systems with MVT 
are invoked in the same manner as those 
under systems with PCP and MFT. They 
result from an ABEND or SNAP macro 
instruction in a system or user program \ 
accompanied by a properly defined data set. 
In the case of a system failure, the damage 
assessment routine (DAR) attempts to write 
a storage image dump to the SYSl.DUMP data 
set- A full explanation of storage image 
dumps may be found in the section headed 
"Storage Image Dump. " The instructions 
that invoke an ABEND/SNAP dump in MVT 



environment are the same as those given in 
the preceding topic for systems with MFT. 
However, some additional consd derations 
must be made in requesting main storage and 
direct access space. 

MVT Considerations : In specifying a region 
size for a job step subject to abnormal 
termination, you must consider the space 
requirements for opening a SYSABEND or 
SYSUDUMP data set (if there is one), and 
loading the ABDUMP routine and required 
data management routines. This space 
requirement can run as high as 6000 bytes. 

Direct access devices are used 
frequently for intermediate storage of dump 
data sets' in systems with MVT. To use 
direct access space efficiently, the space 
for the dump data set should be varied, 
depending on whether or not abnormal 
termination is likely. A small quantity 
should be requested if normal termination 
is expected. To prevent termination of the 
dump due to a lack of direct access space, 
always specify an incremental (secondary) 
quantity when coding a SPACE parameter for 
a dump data set. You can obtain a 
reasonable estimate of the direct access 
space required for an ABEND/SNAP dump by 
adding, (1) the number of bytes in the 
nucleus, (2) the part of the system queue 
space required by the task (9150 bytes is a 
sufficient estimate) , and (3) the amount of 
region space occupied by the task. 
Multiply the sum by 4, and request this 
amount of space in 10 2 4 -byte blocks. 



This formula gives the space 
requirements for one task. Request 
additional space if partial dumps of 
subtasks and invoking tasks will be 
included . 



Contents of an ABEND/SNAP Dump (MVT) 

This explanation of the contents of 
ABEND/SNAP dumps issued by systems with MVT 
is interspersed with sample sections from 
an ABEND dump. Capital letters represent 
the headings found in all dumps, and 
lowercase letters, information that varies 
with each dump. The lowercase letter used 
indicates the mode of the information and 
the number of letters indicates its length: 

• h represents 1/2 byte of hexadecimal 
Information 

'■"•' d represents 1 byte of decimal 
information 

• c represents a 1-byte character 

You may prefer to follow the explanation on 
your own ABEND or SNAP dump. 
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JOB IPCT41 STFP EXSTEP 

COMPLETION CORE SYSTFM « B37 

PSW »T ENTRY TO ABFNO FF040000 5000C408 



PIE OOOOOOOO 

PK-FLG F0850409 
TCB OOOOOOOO 

toe 00000000 

TCT 00030268 



TIME 002409 DATE 99366 



TCB 02F028 


RBP 


0002EC78 1 




MSS 


01031738 1 




FSA 


0106D768 




LTC 


OOOOOOOO 




NSTAE 


OOOOOOOO 


ACTIVF UBS 






PRB 0300F8 


RESV 


OOOOOOOO 




Q/TTR 


OOOOOOOO 


PRB 0309B8 


RESV 


OOOOOOOO 




Q/TTR 


OOOOOOOO 


SVRB 02F0E0 


TAB-LN 00980400 




Q/TTR 


00003COF 




RG 0-" 


7 0O0O0FO9 




RG 8-1 


L5 00039100 




FXTSA 


E2E8E2F5 
80002648 



DEB 


0002ED34 


Tin 


0O0302FO 


CMP 


80B37000 


FLG 


OOOOOOOO 


LLS 


000309BO 


JLB 


OOOOOOOO 


TME 


OOOOOOOO 


J ST 


0002F028 


NTC 


OOOOOOOO 


FCB 


000304 B4 


STA 


OOOOOOOO 


0-POE 


00032668 


USER 


OOOOOOOO 


DAR 


OOOOOOOO 


RESV 


OOOOOOOO 



APSW OOOOOOOO 
WT-LNK 0002F028 



SVRB 02F170 



SVRB 02EC78 



TAB-LN 008803C8 
Q/TTR 00006109 
RG 0-7 80000000 
RS 8-15 00000837 
EXTSA 000029BE 

C5C1F0F1 

TAB-LN 00C803C8 
Q/TTR 00006201 
RG 0-7 OOOOOOOO 
RG 8-15 0002F028 
FXTSA 00620300 

0012C002 



TRN OOOOOOOO 
JPQ 000301E8 
OTC 00030508 
SOS 0002EAA0 
JSCB 0003146C 



WC-SZ-STAB 00040062 FL-CDE 00031290 PSW FFF50006 7003553E 
-STAB 00040002 Ft-CDE 00030EB0 PSW FFF50037 5207EC4A 



APSW OOOOOOOO WC-SZ 
WT-LNK 00030DF8 

APSW F5F5F0E2 WC-SZ-STAB 00120002 

WT-LNK 000309B8 

000396F4 00000003 00000006 

000396F4 000606:0 0003A158 

E306C340 00060DE0 0002EEF4 

00000001 00060FEO C3C45D04 



TQN 



OOOOOOOO PSW FF04000D 5000C408 



00000073 0003BC00 
0003ACE1 000395C0 
0002EFC4 0006DFB8 



00036E88 0003CC33 
5207E434 0007EC10 
00000837 0003036C 



APSW F2F0F1C3 WC-SZ-STAB 00120002 TQN OOOOOOOO PSW 00040033 5000C0CE 
WT-LNK 0002FOEO 

B0B37000 000396F4 4000C182 

0003036C 80002648 00000001 

00060088 2000FFFF 00060BE0 

C9C5C128 C1C2C505 C407B386 



0006DDEO 0002EED4 
00O6OFEO 00002648 
FF030000 0002FIEC 



0002EFC4 00060FB8 
0000DB68 00000001 
0002F1F4 E2E8E2C9 



APSW FIF0F5C1 WC-SZ-STAB 0012D002 

WT-LNK 0002F170 

0002F100 8000BDC8 0000DB68 
4000B03A 0002F028 00060088 
00090040 0008000 A 18002648 
OOOOOOOO OOOOOOOO OOOOOOOO 



PSW FF040001 4007E8A4 



0002F028 0002F170 
00030320 0002F1F4 
00000040 00090041 



00031290 OOOOOOOO 
40000594 OOOOOOOO 
00028460 00000018 



NE 00030BE8 RSP-COE 020301E8 
NE 00031080 RSP-COE 01032260 
NE 000311CO RSP-COE 010323C0 



NE 00030DFO RSP-COE 01032390 
NE 000310C8 RSP-COE 01032390 
NE OOOOOOOO RSP-COE O103OBF0 



NE 00031078 
NE 00031170 



RSP-COE 0JO922W 
RSP-COE 010*2200 



031290 


ATRl 


OB 


NCOE 


000000 


030E80 


ABl 


OB 


NCOE 


031290 


0301E8 


ATRl 


31 


NCOE 


0308F0 


032390 


ATRl 


88 


NCOE 


0323C0 


032290 


ATRl 


B8 


NCOE 


0322C0 


032260 


ATRl 


B8 


NCOE 


032290 


032390 


ATRl 


B8 


NCOE 


0323C0 


032200 


ATRl 


B8 


NCOE 


032230 


0323CO 


ATRl 


B8 


NCOF 


0323F0 


030BFO 


ATRl 


39 


NCOE 


030E80 



ROC-RB 00030DF8 
.ROC-RB 003 09 B 8 
ROt^RfOOOOOOOO 
ROC-RB 03030000 
ROC-RB OOOOOOOO 
R0C-R8 OOOOOOOO 
ROC-RB OOOOOOOO 
ROC-RB OOOOOOOO 
ROC-RB OOOOOOOO 
ROC-RB OOOOOOOO 



NM 


GO 


USE 


01 


EPA 


035508 


ATR2 


20 


XL/MJ 


0312M 


NM 


IEKAAOO 


USE 


01 


EPA 


036240 


.AT**. 


2ft 


XL/JU JDJ&Hi 


NM" 


1GC0A05A 


USE 


02 


EPA 


06C980 


ATR2 


28 


XL/MJ 


030AB0 


NM 


IGG019CD 


USE 


06 


EPA 


07EA00 


ATR2 


20 


XL/MJ 


032380 


NM 


IGG019BA 


USE 


05 


EPA 


07E4A0 


ATR2 


20 


XL/MJ 


032280 


NM 


IGG019BB 


USE 


05 


EPA 


07E880 


ATR2 


20 


XL/MJ 


032250 


NM 


IGG019CD 


USE 


06 


EPA 


07EA00 


ATR2 


20 


XL/MJ 


032380 


NM 


IGG019AJ 


USE 


03 


EPA 


07E3A0 


ATR2 


20 


XL/MJ 


0321F0 


NM 


IGG019AR 


USE 


04 


EPA 


07EC10 


ATR2 


20 


XL/MJ 


0323B0 


NM 


IEWSZOVR 


USE 


01 


EPA 


06C4B0 


ATR2 


20 


XL/MJ 


030B88 



031280 


SZ 


00000010 


NO 


0000000 I 


800002F8 


00035508 










02F398 


sz 


0000004C 


NO 


00000001 


80016E38 


000359C8 


000359C8 


OO030SO0 


010A0400, 


01000500 












011C0300 


01100300 


011E0200 


01290400 


012E0500 


01300500 












0132Q300 


013A0100 


01460600 


01480400 


01400500 




030AB0 


SZ 


00000010 


NO 


00000001 


80000680 


0006C980 










032380 


sz 


00000010 


NO 


00000001 


80000210 


0007EAOO 










032280 


sz 


00000010 


NO 


00000001 


80000180 


0007F4A0 










032250 


sz 


00000010 


NO 


00000001 


80000058 


0007E880 










032380 


sz 


00000010 


NO 


00000001 


80000210 


0007FA0O 










0321F0 


sz 


00000010 


NO 


00000001 


80000100 


0007E3A0 










0323B0 


sz 


00000010 


NO 


00000001 


80000090 


0007EC10 










030B88 


sz 


00000010 


NO 


00000001 


.80000350 


0006C4BO 











DEB 



02E000 

[02E020 

02E040 

02E060 



00000050 OOOOOOOO 0000020A 00002BE0 
8FO00OO0 01000000 OOOOOOOO FF060088 
0001000B 00010001 C2C2C2CI C3C40000 



00000050 00000050 00000050 00000050 
OE003000 0002F028 0402EE04 98000000 
0402ED10 18002648 00000031 00010032 
OOOOOOOO OOOOOOOO OOOOOOOO C3C40000 



* BBBACO. 



Figure 18. Sample of Complete ABEND Dump (MVT) (Part 1 of 2) 
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Figure 18. Sample of Complete ABEND Dump (MVT) (Part 2 of 2) 
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JOB cccccccc STEP cccccccc TIME dddddd 


DATE ddddd 


ID 


- ddd 


PACE dddd 


COMPLETION CODE SYSTEM » hhh (or USER - dddd) 










PSW AT ENTRY TO ABEND (SNAP) hhhhhhhh hhhhhhhh 











JOB CCCCCCCC 

is the job name specified in the JOB 
statement,. 

STEP cccccccc 

is the step name specified in the EXEC 
statement for the problem program 
associated with the task being dumped. 

TIME dddddd 

is the hour (first 2 digits) , minute 
(next 2 digits), and second (last 2 
digits) when the abnormal termination 
dump routine began processing. 

DATE ddddd 

is the year (first 2 digits) and day 
of the year (last 3 digits). For 
example, 67352 would be December 18, 
1967. 

ID=ddd 

is an identification of the dump. For 
dumps requested by an ABEND macro 
instruction, this identification is: 

• Absent if the dump is of the task 
being abnormally terminated. 

• 001 if the dump is of a subtask of 
the task being abnormally 



terminated. (Note that, when a task 
is abnormally terminated, its 
subtasks are also abnormally 
terminated. ) 

• 002 if the dump is of a task that 
directly or indirectly created the 
task being abnormally terminated, up 
to and including the job step task. 

PAGE dddd 

is the page number. Appears at the 
top of each page. Page numbers begin 
at 0001 for each task or subtask 
dumped. 

COMPLETION CODE SYSTEM=hhh or COMPLETION 

CODE USER=dddd 

is the completion code supplied by the 
control program (SYSTEM=hhh) or the 
problem program (USER=dddd) . 

PSW AT ENTRY TO ABEND hhhhhhhh hhhhhhhh or 
PSW AT ENTRY TO SNAP hhhhhhhh hhhhhhhh 

is the PSW for the problem program or 
control program routine that had 
control when abnormal termination was 
requested, or when the SNAP macro 
instruction was executed. It is not 
necessarily the PSW at the time the 
error condition occurred. 



TCB hhhhhh RBP hhhhhhhh PIE 


hhhhhhhh 


DEB hhhhhhhh TIO hhhhhhhh CMP hhhhhhhh 


TRN hhhhhhhh 


MSS hhhhhhhh PK-FLG hhhhhhhh 


FLG hhhhhhhh LLS hhhhhhhh JLB hhhhhhhh 


JPQ hhhhhhhh 


RG 0-7 hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


RG 8-15 hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


FSA hhhhhhhh TCB 


hhhhhhhh 


TME hhhhhhhh JST hhhhhhhh NTC hhhhhhhh 


OTC hhhhhhhh 


LTC hhhhhhhh IQE 


hhhhhhhh 


ECB hhhhhhhh STA hhhhhhhh D-PQE hhhhhhhh 


SQS hhhhhhhh 


NSTAE hhhhhhhh TCT 


hhhhhhhh 


USER hhhhhhhh DAR hhhhhhhh RESV hhhhhhhh 


JSCB hhhhhhhh 



TCB hhhhhh 



PIE hhhhhhhh 



is the starting address of the TCB. 



RBP hhhhhhhh 

is the TCBRBP field (bytes through 
3) : starting address of the active RB 
queue and, consequently, the most 
recent RB on the queue. 



is the TCBPIE field (bytes 4 through 
7): starting address of the program 
interruption element (PIE) for the 
task; however, in an abnormal 
termination dump for the task causing 
the abnormal termination, zeros. The 
field is zeroed by the ABEND routine 
to prevent interruptions during 
dumping. 
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DEB hhhhhhhh 

is the TCBDEB field (bytes 8 through 
11) : starting address of the DEB 
queue. Under the heading DEB in the 
dump, the prefix section for the first 
DEB in the queue is presented in the 
first 8-digit entry on the first line. 
The 6-digit entry at the left of each 
line under DEB is the address of the 
second column on the line, whether or 
not the column is filled. The 
contents of the TCBDEB field may 
differ in the main storage printout 
from what appears in the TCBDEB field 
of the formatted section. This occurs 
when the number of extents specified 
in the DEB for the dump data set is 
not sufficient to complete ABDUMP 
processing. When the dump of main 
storage is given, the END OF VOLUME 
routine may have built another DEB 
having additional extents for the dump 
data set and dequeued the original 
DEB. Therefore, the TCBDEB field in 
the main storage printout may contain 
the address of the new DEB built by 
END OF VOLUME. 



TIO hhhhhhhh 

is the TCBTIO field (bytes 12 through 
15) : starting address of the TIOT. 

CMP hhhhhhhh 

is the TCBCMP field (bytes 16 through 
19) : task completion code or contents 
of register 1 when the dump was 
requested. System codes are given in 
the third through fifth digits and 
user codes in the sixth through eight 
digits. 

TRN hhhhhhhh 

is the TCBTRN field (bytes 20 through 
23) : starting address of the control 
core (table) for controlling testing 
of the task by TESTRAN. 

MSS hhhhhhhh 

is the TCBMSS field (bytes 24 through 
27) : starting address of SPQE most 
recently added to the SPQE queue. 

PK-FLG hhhhhhhh 

contains, in the first 2 digits, the 

TCBPKF field (byte 28): protection 

key. 

contains,, in the last 6 digits, the 
first 3 bytes of the TCBFLGS field 
(bytes 29 through 31) : first 3 flag 
bytes. 



FLG hhhhhhhh 

contains, in the first 4 digits, the 
last 2 bytes of the TCBFLGS (bytes 32 
and 33) : last 2 flag bytes. 



contains, in the next 2 digits, the 

TCBLMP field (byte 34): limit 
priority (converted td an internal 
priority, to 255) . 

contains, in the last 2 digits, the 
TCBDSP field (byte 35) : dispatching 
priority (converted to an internal 
priority, to 255). 

LLS hhhhhhhh 

is the TCBLLS field (bytes 36 through 
39): starting address of the load 
list element most recently added to 
the load list. 

JLB hhhhhhhh 

is the TCBJLB field (bytes 40 through 
43): starting address of the DCB for 
the JOBLIB data set. 

JPQ hhhhhhhh 

is the TCBJPQ field (bytes 41 through 
47): when translated into binary 
bits: 

• Bit is the purge flag. 

• Bits 1 through 7 are reserved for 
future use and are zeros. 

• 3its 8 through 31 are the starting 
address of the queue of CDEs for the 
job pack area control queue, which 
is for programs acquired by the job 
step. 

The TCBJPQ field is used only in the 
first TCB in the job step; it is zeros 
for all other TCBs. 

RG 0-7 and RG 8-15 

is the TCBGRS field (bytes 48 through 
111): contents of general registers 
through 7 and 8 through 15, as stored 
in the save area of the TCB when a 
task switch occurred. These 2 lines 
appear only in dumps of tasks other 
than the task in control when the dump 
was requested. 

FSA hhhhhhhh 

contains, in the first 2 digits, the 
TCBQEL field (byte 112): count of 
enqueue elements. 

contains, in the last 6 digits, the 
TCBFSA field (bytes 113 through 115): 
starting address of the first problem 
program save area. This save area was 
set up by the control program when the 
job step was initiated. 

TCB hhhhhhhh 

is the TCBTCB field (bytes 116 through 
119): starting address of the next 
lower priority TCB on the TCB queue 
or, if this is the lowest priority 
TCB, zeros. 
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TME hhhhhhhh 

is the TCBTME field (bytes 120 through 
123): starting address of the timer 
element created when an STIMER macro 
instruction is issued by the task. 



JST hhhhhhhh 

is the TCBJSTCB field (bytes 124 
through 127) : starting address of the 
TCB for the job step task. For tasks 
with a protection key of zero, this 
field contains the starting address of 
the TCB. 

NTC hhhhhhhh 

is the TCBNTC field (bytes 128 through 
131) : the starting address of the TCB 
for the previous subtask on this 
subtask queue. This field is zero in 
the job step task, and in the TCB for 
the first subtask created by a parent 
task. 

OTC hhhhhhhh 

is the TCBOTC field (bytes 132 through 
135) : starting address of TCB for the 
parent task. In the TCB for the job 
step task, this field contains the 
address of the initiator. 



STA hhhhhhhh 

contains zeros, reserved for future 
use. 



D-PQE hhhhhhhh 

is the TCBPQE field (bytes 152 through 
155): starting address minus 8 bytes 
of the dummy PQE. This field is 
passed by the ATTACH macro instruction 
to each TCB in a job step. 



SQS hhhhhhhh 

is the TCBAQE field (bytes 156 through 
159): starting address of the 
allocation queue element (AQE) . 



NSTAE hhhhhhhh 

contains, in the first 2 digits, STAE 
flags (byte 160). 

contains, in the last 6 digits, the 
TCBNSTAE field (bytes 161 through 
163): starting address of the current 
STAE control block for the task. This 
field is zero if STAE has not been 
issued. 



LTC hhhhhhhh 

is the TCBLTC field (bytes 136 through 
139): starting address of the TCB for 
the most recent subtask created by 
this task. This field is zero in the 
TCB for the last subtask of a job 
step, or in a TCB for a task that does 
not create subtasks. 

IQE hhhhhhhh 

is the TCBIQE field (bytes 140 through 
143): starting address of the 
interruption queue element (IQE) for 
the ETXR exit routine. This routine 
is specified by the ETXR operand of 
the ATTACH macro instruction that 
created the TCB being dumped. The 
routine is to be entered when the task 
terminates. 



ECB hhhhhhhh 

is the TCBECB field (bytes 144 through 
147) : starting address of the ECB to 
be posted by the control program at 
task termination. This field is zero 
if the task was attached without an 
ECB operand. 



TCT hhhhhhhh 

is the TCBTCT field (bytes 164 through 
167): address of the Timing Control 
Table (TCT). 



USER hhhhhhhh 

is the TCBUSER field (bytes 168 
through 171): to be used as the user 
chooses. 



DAR hhhhhhhh 

contains, in the first two digits. 
Damage Assessment Routine (DAR) flags 
(byte 172). 



RESV hhhhhhhh 

reserved for future use. 



JSCB hhhhhhhh 

is the TCBJSCB field (bytes 180 
through 183): the last three bytes 
contain the address of the Job Step 
Control Block. 
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ACTIVE RBS 














cccc hhhhhh 


cccccc hhhhhhhh 
Q/TTR hhhhhhhh 


APSW hhhhhhhh WC-SZ- 
WT-LNK hhhhhhhh 


STAB hhhhhhhh 


cccccc hhhhhhhh PSW 


hhhhhhhh hhhhhhhh 




RG 0-7 hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 




R6 8-15 hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 




EXTSA hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 




hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 







ACTIVE RBS 

identifies the next lines as the 
contents of the active RBs queued to 
the TCB, beginning with the oldest RB 
first. 

cccc hhhhhh 

indicates the RB type (cccc) and 
starting address (hhhhhh) . 

The RB types are: 

PRB program request block 

IRB interruption request block 

SVRB supervisor request block 

cccccc hhhhhhhh 

indicates the RB's function (cccccc) 
and bytes through 3 of the RB 
(hhhhhhhh) : 

• RESV hhhhhhhh indicates PRB or SVRB 
for resident routines. Bytes 
through 3 are reserved for later use 
and contain zeros. 

• TAB-LN hhhhhhhh indicates SVRB for 
transient routines. The first 4 
digits contain the RBTABNO field 
(bytes and 1) : displacement from 
the beginning of the transient area 
control table (TACT) to the entry 
for the module represented by the 
RB. The last 4 digits contain the 
RBRTLNTH field (bytes 2 and 3): 
length of the SVC routine. 

• FL-PSA hhhhhhhh indicates IRB. The 
first 2 digits contain the RBTMFLD 
field (byte 0) : indicators for the 
timer routines. This byte contains 
zeros when the IRB does not 
represent a timer routine. The last 
6 digits contain the RBPSAV field 
(bytes 1 through 3) : starting 
address of the problem program 
register save area (PSA). 



APSW hhhhhhhh 

is the RBABOPSW field (bytes 4 through 
7): 



•In PRB r right half of the problem 
program's PSW when the interruption 
occurred. 

• In IRB or SVRB for type II SVC 
routines, right half of routine's 
PSW during execution of ABEND or 
ABTERM, or zeros. 

• In SVRB for type III or IV SVC 
routines, right half of routine* s 
PSW during execution of ABEND or 
ABTERM, or the last four characters 
of the name of the requested 
routine. (The last two characters 
give the SVC number.) 



WC-SZ-STAB hhhhhhhh 

contains, in the first 2 digits, the 
RBWCSA field (byte 8) : wait count in 
effect at time of abnormal termination 
of the program. 

contains, in the second 2 digits, the 
RBSIZE field (byte 9) : size of the RB 
in doublewords. 

contains, in the last 4 digits, the 
RBSTAB field (bytes 10 and 11): 
status and attribute bits. 



cccccc hhhhhhhh 

indicates the RB* s function (cccccc) 
and bytes 12 through 15 of the RB 
(hhhhhhhh): 

• FL-CDE hhhhhhhh indicates SVRB for 
resident routines, or PRB. The 
first 2 digits contain the RBCDFLGS 
field (byte 12) : control flags. 
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The last 6 digits contain the RBCDE 
field (bytes 13 through 15) : 
starting address of the CDE for the 
module associated with this RB. 

• EPA hhhhhhhh is the RBEP field of an 
IRB (bytes 12 through 15) : 
entry-point address of 
asynchronously executed routine. 

• TQN hhhhhhhh indicates SVRB for 
transient routines. Is the RBSVTQN 
field (bytes 12 through 15) : 
address of the next RB in the 
transient control queue. 

PSW hhhhhhhh hhhhhhhh 

is the RBOPSW field (bytes 16 through 
23) : resume PSW. 

Q/TTR hhhhhhhh 

• In PRBs and SYRBs for resident 
routines, contains zeros in the 
first 2 digits- The last 6 digits 
contain the RBPGMQ field (bytes 25 
through 27) : queue field for 
serially reusable programs (also 
called the secondary queue) . 

• In IRBs, contains the RBUSE field in 
the first 2 digits (byte 24) : count 
of requests for the same exit 
(ETXR). The RBIQE field in last 6 
digits (bytes 25 through 27) : 
starting address of the queue of 
interruption queue elements (IQE), 
or zeros in the first 4 digits and 
the RBIQE field in the last 4 digits 
(bytes 26 and 27) : starting address 
of the request queue elements . 



• In SVRBs for transient routines the 
first 2 digits contain the RBTAWCSA 
field (byte 24) : number of requests 
(used if transient routine is 
overlaid) and the last 6 digits, the 
RBSVTTR field (bytes 25 through 27) : 
relative track address for the SVC 
routine . 



WT-LNK hhhhhhhh 

contains, in the first 2 digits, the 
RBWCF field (byte 28) : wait count. 



contains, in the last 6 digits, the 
RBLINK field (bytes 29 through 31) : 
starting address of the previous RB on 
the active RB queue (primary queuing 
field) or, if this is the first or 
only RB, the starting address of the 
TCB. 

RG 0-7 and RG 8-15 

is the RBGRSAVE field (bytes 32 
through 95): in SVRBs and IRBs, 
contents of registers through 15. 



EXTSA 



In IRBs, contains the RBNEXAV field 
in the first 8 digits (bytes 9 6 
through 99): address of next 
available interruption queue element 
(IQE), and in the remaining digits, 
the interruption queue element work 
space (up to 1948 bytes). 

In SVRBs, contains the RBEXSAVE 
field (bytes 96 through 143) : 
extended save area for SVC routine. 



LOAD LIST 

NE hhhhhhhh RSP-CDE hhhhhhhh 



NE hhhhhhhh RSP-CDE hhhhhhhh 



NE hhhhhhhh RSP-CDE hhhhhhhh 



LOAD LIST 

identifies the next lines as the 
contents of the load list elements 
(LLEs) queued to the TCB by its TCBLLS 
field. The contents of 3 load list 
elements are presented per line until 
all elements in the queue are shown. 

NE hhhhhhhh 

contains, in the first 2 digits, LLE 
byte 0: zeros. 

contains, in the last 6 digits, LLE 
bytes 1 through 3: starting address 
of the next element in the load list. 



RSP-CDE hhhhhhhh 

contains, in the first 2 digits, LLE 
byte 4: the count of the number of 
requests made by LOAD macro 
instructions for the indicated load 
module. This count is decremented by 
DELETE macro instructions. 



contains, in the last 6 digits, LLE 
bytes 5 through 7: starting address 
of the CDE for the load module. 
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ATRl hh NCDE hhhhhh ROC-RB hhhhhhhh NM cccccccc USE hh EPA hhhhhh ATR2 hh XL/MJ hhhhhh 



CDE 



identifies the next lines as the 
contents directory addressed by an LLE 
or RB. One entry is presented per 
line.. 



hhhhhhhh 

is the starting address of the entry 
given on the line. 

ATRl hh 

is the attribute flags. 

NCDE hhhhhh 

is the starting address of the next 
entry in the contents directory. 

ROC-RB hhhhhhhh 

contains, in the first 2 digits, 
zeros. 

contains, in the last 6 digits, the 
starting address of the RB for the 
load module represented by this entry. 



NM cccccccc 

is the name of the entry point to the 
load module represented by this entry. 



USE hh 

is the count of. the uses (through 
ATTACH, LINK, and XCTL macro 
instructions) of the load module, and 
of the number of LOAD macro 
instructions executed for the module. 

EPA hhhhhh 

is the entry point address associated 
with the name in the NM field. 

ATR2 hh 

is the attribute flags. 

XL/MJ hhhhhh 

is the starting address of the extent 
list (XL) for a major CDE, or the 
starting address of the major CDE for 
a minor CDE. (Minor CDEs are for 
aliases.) 



SZ hhhhhhhh NO hhhhhhhh 



LN ADR LN ADR 

hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 



XL 



indicates the next lines are entries 
in the extent list, which is queued to 
the major contents directory entry. 
Each extent list entry is given in one 
or more lines. Only the first line 
for an entry contains the left 3 
columns; additional lines for an entry 
contain information only in the right 
6 columns. 



hhhhhh 

is the starting address of the entry. 

SZ hhhhhhhh 

is the total length, in bytes, of the 



entry. 



NO hhhhhhhh 

is the number of scattered control 
sections in the load module described 
by this entry. If this number is 1, 
the load module was loaded as one 
block. 

LN hhhhhhhh 

gives the length, in bytes, of the 
control sections in the load module 
described by this entry. Bit is set 
to 1 in the last, or only, LN field to 
signal the end of the list of lengths. 

ADR hhhhhhhh 

gives the starting addresses of the 
control sections. Each ADR field is 
paired with the LN field to its left. 
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DEB 




















hhhhhh 






hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 




hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 




hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 




hhhhhh 


hhhhhhhh 


hhhhhhhh 












TIOT 


JOB 
DD 


CCCCCCCC STEP 

hhhhhhhh 


CCCCCCCC 
CCCCCCCC 


PROC CCCCCCCC 

hhhhhhhh hhhhhhhh 











DEB 



identifies the next lines as the 
contents of the DEBs and their prefix 
sections. The first 6 digits in each 
line give the address of the DEB 
contents shown on the line, beginning 
with the second column. The first six 
digits of the first line contains the 
prefix section for the first DEB on 
the queue. 

Note ; DEBs are not formatted if the 
dump is for an OLTEP task. If a dump 
of the DEB chain is desired, use a 
SYSABEND DD card so that the nucleus 
will be dumped. 



JOB CCCCCCCC 

is the name of the job whose task is 
being dumped. 



STEP cccccccc 

is the name of the step whose task is 
being dumped. 



PROC cccccccc 

is the name for the job step that 
called the cataloged procedure. This 
field appears if the job step whose 
task is being dumped was part of a 
cataloged procedure. 



TIOT 



DD 



identifies the next lines as the 
contents of the TIOT. 



identifies the line as the contents of 
the DD entry in the TIOT. 



MSS 




************ SPQE ************ 


a************** 


DQE *************** 


******* FQE 


******** 






FLGS 


NSPQE 


SPID 


DQE 




BLK 


FQE 


LN 


NDQE 


NFQE 


LN 




hhhhhh 


hh 


hhhhhh 


ddd 


hhhhhh 




hhhhhh hhhhhh 


hhhhhh 


hhhhhh 


hhhhhhhh 


hhhhhhhh 


D-PQE 


hhhhhh 


FIRST 


hhhhhhhh 


LAST 


hhhhhhhh 
















PQE 


hhhhhh 


FFB 


hhhhhhhh 


LFB 


hhhhhhhh 


NPQ 


hhhhhhhh 


PPO 


hhhhhhhh 












TCB 


hhhhhhhh 


RSI 


hhhhhhhh 


RAD 


hhhhhhhh 


FLR 


hhhhhhhh 








FBQE 


hhhhhh 


NFB 


hhhhhhhh 


PFB 


hhhhhhhh 


SZ 


hhhhhhhh 












PQE 


hhhhhh 


FFB 


hhhhhhhh 


LFB 


hhhhhhhh 


NPQ 


hhhhhhhh 


PPQ 


hhhhhhhh 












TCB 


hhhhhhhh 


RSI 


hhhhhhhh 


RAD 


hhhhhhhh 


FLR 


hhhhhhhh 








FBQE 


hhhhhh 


NFB 


hhhhhhhh 


PFB 


hhhhhhhh 


SZ 


hhhhhhhh 













MSS 



hhhhhh 



identifies the next lines as the 
contents of the main storage 
supervisor queue. This queue includes 
subpool queue elements (SPQE), 
descriptor queue elements (DQE) , and 
free queue elements (FQE). 



SPQE 



is the starting address of the first 
element shown on the line. 



identifies the 4 columns beneath it as 
the contents of SPQEs. 
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FLGS hh 

is the SPQE flag byte. 

NSPQE hhhhhh 

is the starting address of the next 
SPQE in the queue. 

SPID ddd 

is the subpool number. 

DQE hhhhhh 

for a subpool owned by the task being 
dumped: the starting address of the 
first DQE for the subpool. 

for a subpool that is shared: the 
starting address of the SPQE for the 
task that owns the subpool. 



DQE 



identifies the 4 columns beneath it as 
the contents of DQEs. 



BLK hhhhhh 

is the starting address of the 
allocated 2K block of main storage or 
set of 2K blocks. 

FQE hhhhhh 

is the starting address of the first 
FQE within the allocated blocks. 

LN hhhhhh 

is the length, in bytes, of the 
allocated blocks. 

NDQE hhhhhh 

is the starting address of the next 

DQE. 



FQE 



identifies the 2 columns beneath it as 
the contents of FQEs. 



NFQE hhhhhhhh 

is the starting address of the next 
FQE. 

LN hhhhhhhh 

indicates the number of bytes in the 
free area. 

D-PQE hhhhhh 

is the TCBPQE field (bytes 152 through 
155) : starting address minus 8 bytes 
of the dummy PQE shown on the line. 

FIRST hhhhhhhh 

is the starting address of the first 

PQE. 

LAST hhhhhhhh 

is the starting address of the last 
PQE. 

PQE hhhhhh 

is the starting address of the PQE 
shown on the line. 



FFB hhhhhhhh 

is bytes through 3 of the PQE: 
starting address of the first FBQE.. 
If no FBQEs exist, this field is the 
starting address of this PQE 

LFB hhhhhhhh 

is bytes 4 through 7 of the PQE: 
starting address of the last FBQE. If 
no FBQEs exist, this field is the 
starting address of this PQE. 

NPQ hhhhhhhh 

is bytes 8 through 11 of the element: 
starting address of the next PQE or, 
if this is the last PQE# zeros. 

PPQ hhhhhhhh 

is bytes 12 through 15 of the element: 
starting address of the preceding PQE 
or, if this is the first PQE, zeros. 

TCB hhhhhhhh 

is bytes 16 through 19 of the element: 
starting address of the TCB for the 
job step to which the space belongs 
or, if the space was obtained from 
unassigned free space, zeros. 

RSI hhhhhhhh 

is bytes 20 through 23 of the element: 
size of the region described by this 
PQE (a multiple of 2048). 

RAD hhhhhhhh 

is bytes 24 through 27 of the element: 
starting address of the region 
described by this PQE. 

FLG hhhhhhhh 

is byte 28 of the element : 

bit when 0, indicates space 

described by this PQE is owned; 

when 1, indicates space is 
borrowed. 

bit 1 when 1, indicates region has 

been rolled out (meaningful only 
when bit is 0) . 

bit 2 when 1, indicates region has 
been borrowed. 

bit 3-7, reserved for future use. 



Note : PQE information is contained in two 
lines on the dump. When the rollout/rollin 
feature or Main Storage Hierarchy Support 
is included in the system, PQE information 
(with associated FBQEs) appears once in the 
dump for each region segment of the job 
step. (Each PQE on the partition queue 
defines a region segment. A job step's 
region contains more than one segment only 
when the step has rolled out another step 
or steps, or Main Storage Hierarchy Support 
is present.) 
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FBQE hhhhhh 



PFB hhhhhhhh 



is the starting address of the FBQE 
shown on the line. 



NFB hhhhhhhh 

is bytes through 3 of the element: 
starting address of the next FBQE. In 
the highest or only FBQE, this field 
contains the address of the PQE. 



is bytes 4 through 7 of the element: 
starting address of the previous FBQE. 
In the lowest or only FBQE, the field 
contains the address of the PQE. 



SZ hhhhhhhh 

is bytes 8 through 11 of the element: 
size, in bytes, of the free area. 



QCB TRACE 












MAJ hhhhhh 


NMAJ 


hhhhhhhh 


PMAJ hhhhhhhh 


FMIN hhhhhhhh 


NM cccccccc 


MIN hhhhhh 


FQEL 


hhhhhhhh 


PMIN hhhhhhhh 


NMIN hhhhhhhh 


NM XX xxxxxxxx 




NQEL 


hhhhhhhh 


PQEL hhhhhhhh 


TCB hhhhhhhh 


SVRB hhhhhhhh 



QCB TRACE 

identifies the next lines as a trace 
of the queue control blocks (QCB) 
associated with the job step. Lines 
beginning with MAJ show major QCBs, 
lines beginning with MIN show minor 
QCBs, and lines beginning with NQEL 
show queue elements (QEL). 



MAJ hhhhhh 

is the starting address of the major 
QCB whose contents are given on the 
line. 



NMAJ hhhhhhhh 

is the starting address of the next 
major QCB for the job step. 

PMAJ hhhhhhhh 

is the starting address of the 
previous major QCB for the job step. 

FMIN hhhhhhhh 

is the starting address of the first 
minor QCB associated with the major 
QCB given on the line. 

NM cccccccc 

is the name of the serially reusable 
resource represented by the major QCB. 

MIN hhhhhh 

is the starting address of the minor 
QCB whose contents are given on the 
line. 

FQEL hhhhhhhh 

is the starting address of the first 
queue element (QEL), which represents 
a request to gain access to a serially 
reusable resource or set of resources. 



PMIN hhhhhhhh 

is the starting address of the 
previous minor QCB. 

NMIN hhhhhhhh 

is the starting address of the next 
minor QCB. 

NM xx xxxxxxxx 

indicates, in the first 2 digits, the 
scope of the name or address of the 
minor QCB being dumped. If the scope 
is hexadecimal FF, the name is known 
to the entire operating system. If 
the scope is hexadecimal 00 or 10 
through FO, the name is known only to 
the job step; in this case, the scope 
is the protection key of the TCB 
enqueuing the miner QCB. 

Also contains, in the last 8 digits, 
the name or the starting address of 
the minor QCB. 

NQEL hhhhhhhh 

indicates, by hexadecimal 10 in the 
first 2 digits, that the queue element 
on the line represents a request for 
step-must-complete; by 00, ordinary 
request; and by 20, a 
set-must-complete request. 

Also contains, in the last 6 digits, 
the starting address of the next queue 
element in the queue, or for the last 
queue element in the queue, zeros. 

PQEL hhhhhhhh 

indicates, by hexadecimal 80 in the 
first 2 digits, that the queue element 
represents a shared request or, ty 
hexadecimal 00, that the element 
represents an exclusive request. (If 
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the shared DASD option was selected,, 
hexadecimal 40 in the first 2 digits 
indicates an exclusive RESERVE request 
and 00 indicates a shared RESERVE 
request. ) 



TCB hhhhhhhh 

is the starting address of the TCB 
under which the ENQ macro instruction 
was issued. 



SVRB hhhhhhhh 

is the starting address, of the SVRB 
under which the routine for the ENQ 
macro instruction is executed, or, 
after the requesting task receives 
control of the resource, the UCB 
address of a device being reserved 
through a RESERVE macro instruction 
(the latter value occurs only when the 
shared DASD option was selected). 



SAVE AREA TRACE 
















CCCCCCCC WAS ENTERED VIA LINK (CALL) ddddd 


AT EP CCCCC. . 


• 










SA hhhhhh WD1 hhhhhhhh 


HSA hhhhhhhh 


LSA hhhhhhhh 


RET 


hhhhhhhh 


EPA hhhhhhhh 


R0 


hhhhhhhh 


Rl hhhhhhhh 


R2 hhhhhhhh 


R3 hhhhhhhh 


R4 


hhhhhhhh 


R5 hhhhhhhh 


R6 


hhhhhhhh 


R7 hhhhhhhh 


R8 hhhhhhhh 


R9 hhhhhhhh 


RIO 


hhhhhhhh 


Rll hhhhhhhh 


R12 


hhhhhhhh 


INCORRECT BACK CHAIN 
















INTERRUPT AT hhhhhh 
















PROCEEDING BACK VIA REG 13 

















SAVE AREA TRACE 

identifies the next lines as a trace 
of the save areas for the program. 
Each save area is presented in 3 or 4 
lines. The first line gives 
information about the linkage that 
last used the save area. This line 
will not appear when the RB for the 
linkage cannot be found. The second 
line gives the contents of words 
through 5 of the save area. The third 
and fourth lines give the contents of 
words 6 through 18 of the save area; 
these words are the contents of 
registers through 12. Save areas 
are presented in the following order: 

1. The save area pointed to in the 
TCBFSA field of the TCB. This 
save area is the first one for the 
problem program; it was set up by 
the control program when the job 
step was initiated. 

2. If the third word of the first 
save area was filled by the 
problem program, then the second 
save area shown is that of the 
next lower level module of the 
task. However, if the third word 
of the first area points to a 
location whose second word does 
not point back to the first area, 
the message INCORRECT BACK CHAIN 
appears, followed by possible 
contents of the second save area. 



3. The third, fourth, etc. save 

areas are then shown, provided the 
third word in each higher save 
area was filled and the second 
word of each lower save area 
points back to the next higher 
save area. This process is 
continued until the end of the 
chain is reached (the third word 
in a save area contains zeros) or 
INCORRECT BACK CHAIN appears. 



Following the forward trace, the 
message INTERRUPT AT hhhhhh appears, 
followed by the message PROCEEDING 
BACK VIA REG 13. Then, the save area 
in the lowest level module is 
presented, followed by the save area 
in the next higher level. The lowest 
save area is assumed to be the 76 
bytes beginning with the byte 
addressed by register 13. These two 
save areas appear only if register 13 
points to a full word boundary and 
does not contain zeros. 

CCCCCCCC WAS ENTERED 

is the name of the module that stored 
register contents in the save area. 
This name is obtained from the RB. 

VIA LINK ddddd or VIA CALL ddddd 

indicates the macro instruction (LINK 
or CALL) used to give control to the 
next lower level module, and is the ID 
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operand, if it was specified, of the 
LINK or CALL macro instruction- 



AT EP ccccc... 

is the entry point identifier, which 
appears only if it was specified in 
the SAVE macro instruction that filled 
the save area. 

SA hhhhhh 

is the starting address of the save 
area. 

WD1 hhhhhhhh 

is the first word of the save area 
(optional) . 

HSA hhhhhhhh 

is the second word of the save area: 
starting address of the save area in 
the next higher level module. In the 
first save area in a job step, this 
word contains zeros. In all other 
save areas, this word must be filled. 

LSA hhhhhhhh 

is the third word of the save area 
(register 13) : starting address of 
the save area in the next lower level 
(called) module. If the module 
containing this save area did not fill 
the word, it contains zeros. 

RET hhhhhhhh 

is the fourth word of the save area 
(register 14) : return address 
(optional) ; if the called module did 
not fill the word, it contains zeros. 



EPA hhhhhhhh 

is the fifth word of the save area 



(register 15) : entry point to the 
called module. Use of this word is 
optional; if the called module did not 
fill the word, it contains zeros. 



RO hhhhhhhh Rl hhhhhhhh ... R12 hhhhhhhh 
are words 6 through 18 of the save 
area (registers through 12) : 
contents of registers through 12 for 
the module containing the save area 
immediately after the linkage. Use of 
these words is optional; if the called 
module did not fill these words, they 
contain zeros. 



INCORRECT BACK CHAIN 

indicates that the following lines may 
not be a save area because the second 
word in this area does not point back 
to the previous save area in the 
trace. 

INTERRUPT AT hhhhhh 

is the address of the next instruction 
to be executed in the problem program. 
It is obtained from the resume PSW 
word of the last PRB or LPRB in the 
active RB queue. 

PROCEEDING BACK VIA REG 13 

indicates that the next 2 save areas 
are (1) the save area in the lowest 
level module, followed by (2) the save 
area in the next higher level module. 
The lowest save area is the save area 
pointed to by register 13. These 2 
save areas appear only if register 13 
points to a f ullword boundary and does 
not contain zero. 
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CPUx PSA 




















hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


♦cccccccccccccccccccccccccccccccc* 


hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


♦cccccccccccccccccccccccccccccccc* 


NUCLEUS 




















hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


♦cccccccccccccccccccccccccccccccc* 


hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhhhhhhhhhhh 


hhhhhhhh 


♦cccccccccccccccccccccccccccccccc* 


NUCLEUS 


dONT. 


















hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


♦cccccccccccccccccccccccccccccccc* 


hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*cccccccccccccccccccccccccccccccc* 


REGS AT 


ENTRY TO ABEND (SNAP) 














FLTR 0-6 


hhhhhhhhhhhhhhhh 


hhhhhhhhhhhhhhhh 


hhhhhhhhhhhhhhhh hhhhhhhhhhhhhhhh 


REGS 0-7 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


REGS 8-15 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


LOAD MODULE cccccccc 
















hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*cccccccccccccccccccccccccccccccc* 


hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


♦cccccccccccccccccccccccccccccccc* 


LINES 


hhhhhh-hhhhhh 


SAME AS ABOVE 
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hhhhhhhh 


hhhhhhhh 
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hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*cccccccccccccccccccccccccccccccc* 


hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*cccccccccccccccccccccccccccccccc* 


LINE 


hhhhhh 


SAME AS ABOVE 














CSECT dd 


OF cccccccc 
















hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


♦cccccccccccccccccccccccccccccccc* 


hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


*cccccccccccccccccccccccccccccccc* 



The contents of main storage are given 
under 6 headings: CPUx PSA, NUCLEUS, 
NUCLEUS CONT. , LOAD MODULE cccccccc, CSECT 
dd OF cccccccc, and in the trace table, SP 
ddd BLK hh. Under these headings, the 
lines have the following format: 

• First entry: the address of the 
initial bytes of the main storage 
presented on the line. 

• Next 8 entries: 8 full words (32 
bytes) of main storage in hexadecimal. 

• Last entry (surrounded by asterisks): 
the same 8 full words of main storage 
in EBCDIC, Only A through Z, through 
9 , and blanks are printed; a period is 
printed for anything else. 

The following lines may also appear: 

LINES hhhhhh-hhhhhh SAME AS ABOVE 

are the starting addresses of the 
first and last lines for a group of 
lines that are identical to the line 
immediately preceding. 

LINE hhhhhh SAME AS ABOVE 

is the starting address of a line that 
is identical to the line immediately 
preceding. 



CPUx PSA (Model 65 Multiprocessing dumps 

only) 

identifies the next lines as the 
contents of the prefixed storage area 
(PSA) — through 4095 (FFF). If the 
system is operating in partitioned 
mode (1 CPU) , x is the CPU 
identification. If the system is 
operating in a 2 CPU multisystem mode, 
both PSAs are printed, the first under 
the heading CPUA PSA and the second 
under CPUB PSA. 

NUCLEUS 

identifies the next lines as the 
contents of the nucleus of the control 
program. 

NUCLEUS CONT. 

identifies the next lines as the 
contents of the part of the nucleus 
that lies above the trace table. 

REGS AT ENTRY TO ABEND or REGS AT ENTRY TO 

SNAP 

identifies the next 3 lines as the 
contents of the floating point and 
general registers when the abnormal 
termination routine received control 
in response to an ABEND macro 
instruction or when the SNAP routine 
received control in response to a SNAP 
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macro instruction. These are not the 
registers for the problem program when 
the error occurred. 



FLTR 0-6 

indicates the contents of floating 
point registers 0, 2, 4, and 6. 

REGS 0-7 

indicates the contents of general 
registers through 7. 

REGS 8-15 

indicates the contents of general 
registers 8 through 15. 



LOAD MODULE cccccccc 

identifies the next lines as the 
contents of the main storage area 
occupied by the load module cccccccc 
addressed by an LLE or RB. All the 
modules for the job step are dumped 
under this type of heading. Partial 
dumps do not contain this information. 

CSECT hhhh OF cccccccc 

identifies the next lines as the 
contents of the main storage area 
occupied by the control section 
(CSECT) indicated by hhhh. This 
control section belongs to the 
scatter-loaded load module cccccccc. 



TRACE TABLE 




























DSP 


NEW PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


Rl 


hhhhhhhh 


SW 


hhhhhhhh 


TCB 


hhhhhhhh 


TME 


hhhhhhhh 


I/O 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


Rl 


hhhhhhhh 


RES 


hhhhhhhh 


TCB 


hhhhhhhh 


TME 


hhhhhhhh 


SIO 


CC/DEV/CAW 


hhhhhhhh 


hhhhhhhh 


CSW 


hhhhhhhh 


hhhhhhhh 


RES 


hhhhhhhh 


RES 


hhhhhhhh 


TCB 


hhhhhhhh 


TME 


hhhhhhhh 


SVC 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


Rl 


hhhhhhhh 


RES 


hhhhhhhh 


TCB 


hhhhhhhh 


TME 


hhhhhhhh 


PGM 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


Rl 


hhhhhhhh 


RES 


hhhhhhhh 


TCB 


hhhhhhhh 


TME 


hhhhhhhh 


EXT 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


Rl 


hhhhhhhh 


RES 


hhhhhhhh 


TCB 


hhhhhhhh 


TME 


hhhhhhhh 



TRACE TABLE (SNAP dumps only) 

identifies the next lines as the 
contents of the trace table. Each 
trace table entry is presented on one 
line; the name at the beginning of 
each line identifies the type of entry 
on the line: 



• DSP Dispatcher entry 

• I/O Input/output interruption entry 

• SIO Start input- output (SIO) entry 

• SVC Supervisor call (SVC) 

interruption entry 

• PGM Program interruption entry 

• EXT External interruption entry 

OLD PSW hhhhhhhh hhhhhhhh 

is the PSW stored when the 
interruption represented by the entry 
occurred. 

NEW PSW hhhhhhhh hhhhhhhh 

is the new PSW stored in the entry. 

CC/DEV/CAW hhhhhhhh hhhhhhhh 

contains, in the first 2 digits: 
completion code. 

contains, in the next 6 digits: 
device type. 



contains, in the last 8 digits: 
address of the channel address word 
(CAW) stored in the entry. 

R15/RO hhhhhhhh hhhhhhhh 

contains, in the first 8 digits: 
contents of register 15 stored in the 
entry. 

contains, in the last 8 digits: 
contents of register stored in the 
entry. 

CSW hhhhhhhh hhhhhhhh 

is the channel status word (CSW) 
stored in the entry. 

Rl hhhhhhhh 

is the contents of register 1 stored 
in the entry. 

RES hhhhhhhh 

is reserved for future use; all digits 
are zeros . 

SW hhhhhhhh 

is reserved for future use; all digits 
are zeros . 

TCB hhhhhhhh 

is the starting address of the TCB 
associated with the entry. 

TME hhhhhhhh 

is a representation of the timer 
element associated with the entry. 
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TRT 
X DSP 


NEW PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


NUA 


hhhhhhhh 


NUB 


hhhhhhhh 


TME 


hhhhhh 


X I/O 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


CSW 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


OLA 


hhhhhhhh 


OLB 


hhhhhhhh 


TME 


hhhhhh 


X SIO 


CC/DEV/CAW 


hhhhhhhh 


hhhhhhhh 


CSW 


hhhhhhhh 


hhhhhhhh 


TCB 


hhhhhhhh 


OLA 


hhhhhhhh 


OLB 


hhhhhhhh 


TME 


hhhhhh 


X SVC 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


R1 5/RO 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


OLA 


hhhhhhhh 


OLB 


hhhhhhhh 


TME 


hhhhhh 


X PGM 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


OLA 


hhhhhhhh 


OLB 


hhhhhhhh 


TME 


hhhhhh 


X EXT 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


MSK 


hhhhhhhh 


TQE 


hhhhhhhh 


TME 


hhhhhh 


X SSM 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


APF 


yyhhhhhh 


OLB 


hhhhhhhh 


TME 


hhhhhh 



TRT (MVT with Model 65 multiprocessing 

dumps only) 

identifies the next lines as the 
contents of the trace table. Each 
trace table entry is presented on one 
line; the letter and name at the 
beginning of each line identify the 
CPU and the type of entry, 
respectively : 



• DSP Dispatcher entry. 

• I/O Input/ output interruption 

entry. 

• SIO Start input/output entry. 

• SVC Supervisor call interruption 

entry. 

• PGM Program interruption entry. 

• EXT External interruption entry. 

• SSM Set system mask entry. 

OLD PSW hhhhhhhh hhhhhhhh 

is the PSW stored when the 
interruption represented by the entry 
occurred. 

NEW PSW hhhhhhhh hhhhhhhh 

is the new PSW stored in the entry. 

CC/DEV/CAW hhhhhhhh hhhhhhhh 

contains, in the first 2 digits: 
completion code; in the next 6 digits: 
device type; in the last 8 digits: 
address of the channel address word 
stored in the entry. 

R15/R0 hhhhhhhh hhhhhhhh 

contains, in the first 8 digits: 
contents of register 15; in the last 8 
digits: contents of register „ both 
as stored in the entry. 



CSW hhhhhhhh hhhhhhhh 

is the channel .status word stored in 
the entry. 

Rl hhhhhhhh 

is the contents of register 1 as 
stored in the entry. 

TCB hhhhhhhh 

is the starting address of the TCB 
associated with the entry. 

NUA hhhhhhhh 

is the starting address of the new TCB 
for CPU A, as stored in the entry. 

OLA hhhhhhhh 

is the starting address of the old TCB 
for CPU A, as stored in the entry. 

MSK hhhhhhhh 

is the STMASK of the other CPU as 
stored in the entry. 

NUB hhhhhhhh 

is the starting address of the new TCB 
for CPU B, as stored in the entry. 

OLB hhhhhhhh 

is the starting address of the old TCB 
for CPU B, as stored in the entry. 

TQE hhhhhhhh 

is the first word of the timer queue 
element stored in the entry, provided 
a timer interrupt occurred. 

TME hhhhhhhh 

is a representation of the timer 
element associated with the entry. 

AFF yyhhhhhh 

contains, in the first 2 digits: the 
ID of the locking CPU at the time of 
the interrupt; in the last 6 digits: 
starting address of the old TCB for 
CPU A, as stored in the entry. 
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SP ddd 










hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


*cccccccccccccccccccccccccccccccc* 


hhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


*cccccccccccccccccccccccccccccccc* 


END OF 


DUMP 









SP ddd 

identifies the next lines as the 
contents of a block of main storage 
obtained through a GETMAIN macro 
instruction, and indicates the subpool 
number (ddd) . The part of subpool 252 
that is the supervisor work area is 
presented first, followed by the 
entire contents of any problem program 
subpools (0 through 127) in existence 
during the dumping. 

END OF DUMP 

indicates that the dump or snapshot is 
completed. If this line does not 
appear, the ABDUMP routine was 
abnormally terminated before the dump 
was completed, possibly because enough 
space was not allocated for the dump 
data set. 



Guide to Using an ABEND/SNAP Dump (MVT) 

Cause of Abnormal Termination : Evaluate 
the user (USER=decimal code) or system 
(SYSTEM=hex code) completion code using 
Appendix B or the publication Messages and 
Codes . 

Dumped Task ; Check the ID field for an 
indication of which task is being dumped in 
relation to the task that was abnormally 
terminated : 

• 001 indicates a partial dump of a 
subtask 

• 002 indicates a partial dump of the 
invoking task 

If the ID field is absent, the dump 
contains a full dump of the task that was 
abnormally terminated. 

Active RB Queue ; The first RB shown on the 
dump represents the oldest RB on the queue. 
The RB representing the load module that 
had control when the dump was taken is 
third from the bottom. The last RB 
represents the ABDUMP routine and the 
second from last,, the ABEND routine. The 
load module name and entry point (for a 
PRB) are given in a contents directory 
entry, the address of which is shown in the 
last 3 bytes of the FL/CDE field. 



Program Check PSW ; The program check old 
PSW is the fifth entry in the first line of 
each RB printout. It is identified by the 
subheading APSW, For debugging purposes, 
the APSW of the third RB from the bottom of 
the dump is most useful. It provides the 
length of the last instruction executed in 
the program (bits 32,33), and the address 
of the next instruction to be executed 
(bytes 5-8). 

Load List ; Does the resume PSW indicate an 
instruction address outside the limits of 
the load module that had control at the 
time of abnormal termination? If so, look 
at the LLEs on the load list. Each LLE 
contains the CDE address in the dump field 
labeled RSP-CDE. 

CDEs ; The entries in the contents 
directory for the region are listed under 
the dump heading CDE. The printouts for 
each CDE include the load module and its 
entry point. If you have a complete dump, 
each load module represented in a CDE is 
printed in its entirety following the 
NUCLEUS section of the dump. 

Trace Table (SNAP dumps only) ; Entries on 
an MVT SNAP dump, if valid, represent 
occurrences of SIO, external, SVC, program, 
I/O, and dispatcher interruptions. SIO 
entries can be used to locate the CCW 
(through the CAW) , which reflects the 
operation initiated by an SIO instruction. 
If the SIO operation was not successful, 
the CSW STATUS portion of the entry will 
show you why it failed. EXT and PGM 
entries are useful for locating the 
instruction where the interruption occurred 
(bytes 5-8 of the PSW). 

SVC trace table entries provide the SVC old 
PSW and the contents of registers 0, 1, and 
15. The PSW offers you the hexadecimal SVC 
number (bits 20-31), the CPU mode (bit 15), 
and the address of the SVC instruction 
(bytes 5-8). The contents of registers 
and 1 are especially useful in that many 
system macro instructions pass key 
information in these registers. (see 
Appendix A. ) 

I/O entries reflect the I/O old PSW and the 
CSW that was stored when the interruption 
occurred. From the PSW, you can learn the 
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address of the device that caused the 
interruption (bytes 2 and 3) f the CPU state 
at the time of interruption (bit 15) , and 
the instruction address where the 
interruption occurred (bytes 5-8). The CSW 
provides you with the unit status (byte 4)* 
the channel status (byte 5),, and the 
address of the previous CCW plus 8 (bytes 
0-3). 

You can use the DSP entry to delimit the 
entries in the trace table. To find all 
entries for the terminated task, scan word 
7 of each trace table entry for the TCB 
address in a DSP entry. The lines between 
this and the next DSP entry represent 
interruptions that occurred in the task. 

Region Contents ; Free areas for the region 
occupied by the dumped task are identified 
under headings PQE and FBQE. The field 



labeled SZ gives the number of bytes in the 
free area represented by the FBQE. 

Subpool Contents : Free and requested areas 
of the subpools used by the dumped task are 
described under the dump heading MSS. 
Subpool numbers are given under the SPID 
column in the list of SPQEs. If a GETMAIN 
macro instruction was issued without a 
subpool specification, space is assigned 
from subpool 0. Thus, two SPQEs may exist 
for subpool 0. The sizes of the requested 
areas and free areas are given under the LN 
column in the lists of DQEs and FQEs, 
respectively. 

Load Module Contents ; The contents of each 
load module used by the job step are given 
under the heading XL. Each entry includes 
the sizes (LN) and starting addresses (ADR) 
of the control sections in the load module. 
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Indicative Dump 



First digit: 



An indicative dump is issued when a task is 
abnormally terminated by an ABEND macro 
instruction, and a dump is requested, but a 
dump data set is not available, due either 
to omission or incorrect specification of a 
SYSABEND or SYSUDUMP DD statement. An 
indicative dump is issued automatically on 
the system output (SYSOUT) device.. 

Systems with MVT do not issue indicative 
dumps. 



Contents of an Indicative Dump 

This explanation of indicative dumps 
utilizes capital letters for the headings 
found in all dumps, and lowercase letters 
for information that varies with each dump. 
The lowercase letter used indicates the 
mode of the information, and the number of 
letters indicates its length: 



Bit Setting Meaning 



Instruction image not 
present 

1 Instruction image present 

Floating-point registers 
not present 

1 Floating-point registers 
present 

One general register set 
present 

1 Two general register sets 
present 

All active RBs present 

1 All active RBs not present 



Last digit: 

Digit in 
Hexadecimal Meaning 

All loaded RBs present 



• h represents 1/2 byte of hexadecimal 
information 

• d represents 1 byte of decimal 
information 

• c represents a 1-byte character 



Figure 19 shows the contents of an 
indicative dump. You may prefer to follow 
the explanation on your own indicative 
dump. 

CONTROL BYTE=hh 

describes the contents of the 
indicative dump. 



8 



All loaded RBs not present 



TCB FLAGS=hh 

is the first byte of TCBFLGS field 
(byte 29 in the TCB for the program 
being dumped): task end flag byte: 

Bit Setting Meaning 







Abnormal termination in 
process 

Normal termination in 
process 

Abnormal termination was 
initiated by the resident 
ABTERM routine 



TCB FLAGS=hh NO. ACTIVE RB=dd 
- SYSTEM»hhh USER=dddd 



NC. LOAD RB=dd 



I CONTROL BYTE=hh 
(COMPLETION CODE 

REGISTER SET 1 ._._......._,_._ 

| hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 

hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 

REGISTER SET 2 ^^..w^ 

hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 

hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
INSTRUCTION IMAGE=hhhhhhhhhhhhhhhhhhhhhhhh 

hhhhhhhhhhhhhhhh hhhhhhhhhhhhhhhh hhhhhhhhhhhhhhhh 

PROGRAM ID=cccccccc RB TYPE=hh ENTRY POINT=hhhhhh ,.,_,.,.,.,. 
RESUME PSW SM=hh K=h AMWP=h IC=hhhh IL.CC=h PM=h IA=hhhhhh 

PROGRAM ID=CCCCCCCC RB TYPE=hh ENTRY POINT=hhhhhh 



hhhhhhhh 
hhhhhhhh 

hhhhhhhh 
hhhhhhhh 



hhhhhhhh 
hhhhhhhh 

hhhhhhhh 
hhhhhhhh 



hhhhhhhh 
hhhhhhhh 

hhhhhhhh 
hhhhhhhh 



hhhhhhhhhhhhhhhh 



Figure 19. Contents of an Indicative Dump 
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NO. 



NO. 



3 1 ABTERM routine * entered 

because of program 
interruption 

4 1 Reserved for future use 

5 1 Data set closing initiated 

by the ABTERM routine 

6 1 The ABTERM routine 

overlaid some or all of 
the problem program 

7 1 The system prohibited 

queuing of asynchronous 
exit routines for this 
task 

ACTIVE RB=dd 
is the number of active RBs presented 
in the dump. 

LOAD RB=dd 
is the number of RBs in the load list 
presented in the dump. 



COMPLETION CODE SYSTEM=hhh USER=dddd 

is the completion code supplied by the 
control program (SYSTEM=hhh) or the 
problem program (USER=dddd) . Both 
SYSTEM=hhh and USER=dddd are printed; 
however, one of them is always zero. 



• Lost control to the input/output 
interruption handler,, which 
subsequently terminated' abnormally. 

• Was abnormally terminated by the 
control program because of a program 
interruption. 

• Issued an ABEND macro instruction to 
request an abnormal termination. 

If REGISTER SET 2 also appears in the 
dump,, the lines under REGISTER SET 1 
give the general register contents for 
a type II, III, or IV SVC routine 
operating under an SVRB. 

REGISTER SET 2 

indicates that the next 2 lines give 
the contents of general registers 
through 7 and 8 through 15 for a 
program being executed under control 
of an RB other than an SVRB when the 
program last passed control to a type 
II,, III, or IV SVC routine. 

INSTRUCTION IMAGE=hhhhhhhhhhhhhhhhhhhhhhhh 
is 12 bytes of main storage, with the 
instruction that caused a program 
interruption in the right part of the 
printout. This field appears only if 
a program interruption occurred and is 
also valid when the instruction length 
in the resume PSW is 0. 



cccccc . 



explains the completion code or, 
program interruption occurred: 



if a 



PROGRAM INTERRUPTION ccccc... AT 

LOCATION hhhhhh 

where ccccc is the program 
interruption cause: OPERATION, 
PRIVILEGED OPERATION, EXECUTE , 
PROTECTION, ADDRESSING, 
SPECIFICATION, DATE, FIXED-POINT 
OVERFLOW, FIXED- POINT DIVIDE, 
DECIMAL OVERFLOW, DECIMAL DIVIDE, 
EXPONENT OVERFLOW, DECIMAL 
DIVIDE,, EXPONENT OVERFLOW, 
EXPONENT UNDERFLOW, SIGNIFICANCE, 
or FLOATING-POINT DIVIDE; and 
hhhhhh is the address of the 
instruction being executed when 
the interruption occurred. 



REGISTER SET 1 

indicates that the next 2 lines give 
the contents of general registers 
through 7 and 8 through 15 for a 
program being executed under control 
of an RB when it: 

• Passed control to a type I SVC 
routine through an SVC instruction 
and the routine terminated 
abnormally. 



hhhhhhhhhhhhhhhh hhhhhhhhhhhhhhhh 
hhhhhhhhhhhhhhhh hhhhhhhhhhhhhhhh 

are the contents of floating-point 
registers 0,, 2, 4, and 6 when the, 
abnormal termination occurred. This 
field appears only if the floating 
point option is present. The first 2 
digits of each register are the 
characteristic of the floating point 
number. The last 14 digits are the 
mantissa . 



PROGRAM ID=cccccccc 

is the XRBNM field (bytes through 
7): in PRB, LRBs, and LPRBs, the 
program name; in IRBs, the first 
character contains flags for the timer 
or, if the timer is not being used, 
contains no meaningful information; in 
SVRBs for a type II SVC routine,, 
contains no meaningful information; in 
SVRBs for a type III or IV SVC 
routine, the first 4 bytes contain the 
relative track address (TTR) of the 
load module in the SVC library and the 
last 4 bytes contain the SVC number in 
signed, unpacked decimal; in SIRBs, 
the name of the error routine 
currently occupying the 400-byte 
input/output supervisor transient 
area. 
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RB TYPE=hh 

indicates the type of active RB 

hh Type of RB 

00 PRB that does not contain entry 

points identified by IDENTIFY 

macro instructions 



PM=h 



is bits 36 through 39 of PSW: program 
mask. 



IA=hhhhhh 

is bits 40 through 63 of PSW: 
instruction address. 



10 PRB that contains one or more 
entry points identified by 
IDENTIFY macro instructions 

20 LPRB that does not contain entry 
points identified by IDENTIFY 
macro instructions 

30 LPRB that contains one or more 
entry points identified by 
IDENTIFY macro instructions 

40 IRB 

80 SIRB 

CO SVRB for a type II SVC routine 

DO SVRB for a type III or IV SVC 
routine 

E0 LPRB for an entry point identified 
by an IDENTIFY macro instruction 

F0 LRB 

ENTRY POINT=hhhhhh 

is the XRBEP field (bytes 13 through 
15) : address of entry point in the 
program. 

RESUME PSW 

XRBPSW field (bytes 16 through 23); 
is the contents of the resume PSW. 



SM=hh 



K=h 



is bits through 7 of PSW: system 
mask. 

is bits 8 through 11 of PSW: 
protection key. 



AMWP=h 

is bits 12 through 15 of PSW: 
indicators . 

IC=hhhh 

is bits 16 through 31 of PSW: 
interruption code. 

IL. CC=h 

is bits 32 through 35 of PSW: 
instruction length code (bits 32 and 
33) and condition code (bits 34 and 
35). 



PROGRAM ID=cccccccc 

is the XRBNM field (bytes through 
7): program name. 

RB TYPE=hh 

indicates the type of RB: 



hh 
20 



30 



E0 



F0 



Type of RB 

LPRB that does not contain entry 

points identified by IDENTIFY 

macro instructions. 

LPRB that contains one or more 

entry points identified by 

IDENTIFY macro instructions. 

LPRB for an entry point identified 

by an IDENTIFY macro instruction. 

LRB. 



ENTRY POINT=hhhhhh 

is the XRBEP field (bytes 13 through 
15): address of entry point in the 
program. 

Guide to Using an Indicative Dump 

Completion Code : Evaluate the user 
(USER=decimal code) or system (SYSTEM=hex 
code) completion code using either Appendix 
C of this publication or the publication 
Messages and Codes . The line under the 
completion code gives a capsule explanation 
of the code or the type of program 
interruption that occurred. 

Instruction Address : If a program 
interruption occurred, get the address of 
the erroneous instruction in the last 3 
bytes of the field labeled INSTRUCTION 
IMAGE . 

Active RB Queue : RBs are shown in the 
first group of two-line printouts labeled 
PROGRAM ID and RESUME PSW, with the most 
recent RB shown first. There are two lines 
for as many RBs indicated by NO. ACTIVE 
RB=dd. 

Register Contents : General register 
contents at the time a program last had 
control are given under the heading 
REGISTER SET 2 or, if this heading is not 
present, under REGISTER SET 1. Register 
contents, particularly those of register 
14, may aid you in locating the last 
instruction executed in your program. 
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Storage Dumps 



Storage dumps record the contents of main 
storage from location 00 to the end of 
printable storage- 
Storage dumps are produced by the damage 
assessment routine (DAR) or other system 
recovery routines, the Console Dump 
facility, or the stand-alone service aid 
program IMDSADMP. 



DAMAGE ASSESSMENT ROUTINE (DAR) 

The damage assessement routine produces a 
storage dump when a system task fails and 
is designed to provide increased system 
availability in the event of system 
failure. The storage dump is written to 
the SYS1.DUMP data set. 

If a system routine fails, DAR attempts 
to reinitialize the failing task, thereby 
permitting the system to continue operation 
without interruption. DAR permits the 
system to continue processing in a degraded 
condition if it encounters a system failure 
that does not permit total reinstatement of 
the affected task or region. The operator 
will be informed, via a WTO, that the 
system is in an unpredictable state; he 
then must decide whether or not 
already-scheduled jobs should be allowed to 
attempt completion. 

Note ; If TSO is installed in the system 
and a failure occurs in the TSO subsystem 
or in the operating system the TSO SWAP 
data set must be recorded for use in 
diagnosis if needed. The system recovery 
routines do not do this. The IMDPRDMP 
service aid can be used as a 
high-performance dumping program for this 
purpose by directing its output to tape. 
Refer to the Service Aids publication for 
details of this usage of the IMDPRDMP 
program. 



CONSOLE DUMP 

The Console Dump function is designed to 
meet the requirements for a dynamic main 
storage dumping tool in the operating 
system. The operator initiates the Console 
Dump from the primary console via a DUMP 
command. Execution of the function allows 
a dump to be taken to the SYS1.DUMP data 
set of all or selective portions of main 
storage. The dump operation is performed 
during system operation and requires no 
IPL. The storage dump may then be 
formatted and printed by the IMDPRDMP 
Service Aid program. Refer to the 
Operator's Guide publication for details of 
the DUMP command. 



IMDSADMP SERVICE AID 

In situations where the system is not 
operative, an IMDSADMP program is loaded 
into storage through use of the IPL 
facilities. The storage dump taken may be 
written in a high-speed version to tape or 
disk, and in a low speed version to tape or 
printer. The high-speed IMDSADMP dump must 
be processed by the IMDPRDMP program. The 
low-speed tape output may be processed by a 
program such as the IEBGENER utility 
program. The format of the low- speed 
IMDSADMP output is similar to the general 
format listing produced by the IMDPRDMP 
program and therefore is not illustrated in 
this publication. A sample IMDSADMP 
listing and a discussion of the program are 
contained in the Service Aids publication. 



SYSTEM FAILURE 

If a system failure occurs, the damage 
assessment routine immediately attempts to 
write a storage dump to the SYS1.DUMP data 
set. A system failure may be caused by a 
failure in any of the following system 
tasks: 



MFT: 



Communications Task 
Master Scheduler Task 
Log Task 



MVT: 



System Error Task 
Rollout/Rollin Task 
Communications Task 
Master Scheduler Task 
Transient Area Fetch Task 

A system failure is also caused by an 
ABEND recursion in other than OPEN, CLOSE, 
ABDUMP, or STAE; by a failure of a task in 
•must complete* status; or, in MFT only, by 
a failure in the scheduler if no SYSABEND 
or SYSUDUMP DD card is provided. 



THE SYS1.DUMP DATA SET 

The SYS1.DUMP data set may reside on tape 
or on a direct access device. 

Tape 

If you wish to have the SYS1.DUMP data set 
reside on tape, you may specify the tape 
drive during IPL. If the drive has not 
been made ready prior to IPL, a MOUNT 
message is issued to the console, 
specifying the selected device. The device 
should be mounted with an unlabeled tape. 
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After writing a storage image dump, the 
damage assessment routine writes a tape 
mark and will position the tape to the next 
file. The tape drive will remain in a 
ready state to receive another storage 
image dump. 



Direct Access 

If you wish to have the SYS 1. DUMP data set 
placed on a direct access device, you may 
preallocate the data set at system 
generation or prior to any IPL of the 
system. The following restrictions apply: 

• The data set name must be SYS1.DUMP. 

• The data set must be cataloged on the 
IPL volume. 



• The data set may be preallocated on any 
volume that will be online during 
system operation. 



• The data set must be sequential. 

• Sufficient space must be allocated to 
receive a storage image dump for all of 
main storage. 

When a direct access device is used for 
the SYSl.DUMP data set, the data set can 
hold only one storage dump. If additional 
failures occur, and if the SYSl.DUMP data 
set is occupied, DAR does not attempt to 
write another storage image dump. 

Use the IMDPRDMP service aid to format 
and list the SYSl.DUMP data set. 
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IMDPRDMP Output 

Main storage information processed by the 
IMDPRDMP program is presented in six 
different output formats. The output 
format used is determined by the function 
of the particular area of the dumped 
system's main storage that is being 
printed. Two of these formats, the queue 
control block trace and the link pack area 
map,, are invoked by specific format 
statements. A third format is used to 
print the major system control blocks. Two 
formats are used for TSO; one for system 
control blocks and the other for user 
control blocks. Any areas of the dumped 
system's main storage that do not fall into 
any of the aforementioned functional 
categories are processed in the general 
format. 



• The number of permanent I/O errors 
encountered during the execution; 

• The average number of buffers used for 
each operation performed during this 
execution; 

• The number of blocks read from the TSO 
swap data sets; 

• The ratio of the number of times the 
read routine was called to the number 
of times the requested address was not 
in a buffer. 

• When processing Generalized Trace 
Facility output, the number of trace 
records processed. 



Dump List Headings ; Each page of output 
listing contains a heading. This heading 
has the optional user specified title, the 
name of the module that invoked the dump, 
the date and the time the dump was taken 
except when processing Generalized Trace 
Facility output when the heading will be 
"EXTERNAL TRACE - DD ddname. " Note ; If 
the dump was produced by IMDSADMP on a 
system with the time-of-day (TOD) clock, 
IMDPRDMP can not determine the time at 
which the dump was taken; the time is 
replaced by "TOD CLK." 

Dump Header ; If the dump was produced by 
SVC DUMP, IMDPRDMP will print the title 
taken from the dump header record. A 
maximum of 100 characters are printed on 
the second line of the first page of the 
output listing. 

Output Comments ; While formatting the 
dump, the IMDPRDMP program occasionally is 
unable to locate, format and print a 
control block. On those occasions IMDPRDMP 
prints a comment explaining why the control 
block could not be formatted and printed. 
These comments are printed within the body 
of the formatted dump and are part of the 
IMDPRDMP output. A complete list of these 
output comments along with further 
explanations is contained at the end of 
this chapter. 

Summary Information ; In addition to 
formats, the following summary information 
is printed at the end of each execution of 
IMDPRDMP; 

• The number of entries to the read 
routine; 

• The number of times that the required 
address was not found in a buffer; 

• The number of blocks read from the dump 
data set; 



QUEUE CONTROL BLOCK TRACES 

In a multiprogramming environment, requests 
for system resources are enqueued. This 
process is accomplished through the use of 
queue control blocks (QCBs). 

Certain system failures, such as task 
contention deadlocks, become evident to the 
user upon examination of a queue control 
block trace. When requested through the 
use of the QCBTRACE statement, the QCB 
trace appears on a separate page of the 
IMDPRDMP program dump listing. The trace, 
a sample of which appears in Figure 20, 
contains a listing of all queue control 
blocks that were present in the dumped 
system, and is available to users who are 
processing main storage information 
gathered from an MVT or MFT system. 

(For more information on system resource 
queuing, see IBM System/360 Operating 
System; MVT Supervisor , GY28-6659.) 

The page of the IMDPRDMP listing 
containing the Queue Control Block trace is 
identified by two heading lines. The first 
line contains an optional title, the name 
of the module that invoked the dump, and 
the date and time that the information was 
gathered from the dumped system. The 
second line of the heading identifies the 
page as containing a Queue Control Block 
trace. The individual QCBs are then listed 
for each Task Control Block. Each Queue 
Control Block is formatted as follows; 

MAJOR hhhhhh 

The starting address of a major queue 
control block, the contents of which 
are given, indented, on the line or 
lines below. 

NAME cccccccc 

The name of the system resource 
represented by the major QCB. 
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SAMPLE QCB TRACE MODULE IMDSADMP DATE 7/04/70 TIME 0.10 

**** QUEUE CONTROL BLOCK TRACE **** 



PAGE 



MAJOR 024100 NAME SYSDN 

MINOR 0239AO 

QEL 024068 

MINOR 023838 

QEL 023ED8 



NAME FF SYS1.LINKLIB 
TCB 023488 SHARED 

NAME FF SYSl.MACLIB 
TCB 023448 SHARED 



MAJOR 0235E8 NAME SYSIEFSD 

MINOR 0235C8 NAME FF Q5 

QEL 023208 TCB 023480 EXCLUSIVE 
QEL 023C10 TCB 023 8E0 EXCLUSIVE 



Figure 20. Queue Control Block Trace Sample 



MINOR hhhhhh 

The starting address of the minor 
queue control block. Contents are 
given on this line or the lines below.. 

NAME hh cccccccc 

The first two characters appearing 
after the NAME field identifier 
indicate the scope of the minor QCB 
being dumped. If the scope is given 
as hexadecimal FF, the name of the QCB 
is known to the entire operating 
system. If the scope indicator is 
hexadecimal 00 or 10 through F0, the 
name of the QCB is known only to the 
job step. The scope indicator shows 
the storage protection key of the TCB 
that enqueued this minor QCB. The 
NAME field also contains the name of 
the specific system resource 
represented by the minor QCB. 

QEL hhhhhh 

The address of a queue element (QEL) 
associated with the minor QCB 
described on the line above. A QEL 
line appears for each resource 
requested by the task associated with 
the minor QCB. 

TCB hhhhhh 

The starting address of the task 
control block of the requesting task. 
This task requests a specific system 
resource through the use of the QEL 
indicated on this line. 

SHARED or EXCLUSIVE 

This indicator tells whether the 
system resource is available to one 
task (EXCLUSIVE) or several tasks 
(SHARED) . 



LINK PACK AREA MAPS 

Information on routines residing in either 
the MVT link pack area or the MFT resident 
reenterable load module area of the dump 
system is available to the user through use 
of the LPAMAP (link pack area map) format 
statement. 



For users who are processing an MVT 
dump, the IMDPRDMP program produces a 
listing of all routines loaded into the 
link pack area by the nucleus 
initialization program (NIP) . For MFT 
dumps,, this list contains information 
pertaining to all resident reentrant 
routines loaded into the reenterable load 
module area by NIP. 

The IMDPRDMP user will find the link 
pack area map, for MVT, or the reenterable 
load module area map, for MFT, to be a 
useful tool in isolating system failures 
that occurred in program modules that 
reside outside the user* s partition or 
region. If requested, the applicable map 
appears on a separate page of the IMDPRDMP 
program dump listing. A sample Link Pack 
Area map is shown in Figure 21 . 



The dump listing page containing the 
link pack area map is identified by two 
heading lines. The first line contains the 
optional title supplied by the user, the 
name of the module that invoked the dump,, 
and the date and time that the information 
was gathered from the dumped system. The 
second line of the heading identifies the 
page as containing a link pack area map. 
Information on each module contained in the 
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link pack area or reenterable load module 
area,, is given in the following format: 



NAME cccccccc 

The name of the load module 
represented by this entry. 

EPA hhhhhh 

The entry point address of the module 
identified on the corresponding line 
in the NAME column. 

STA hhhhhh 

The starting address of the named 
module's control section. 



LNGH hhhhhh 

The length, in bytes, of the control 
sections in the load module described 
on this line.. 

TYPE ccccc 

The attributes of the control block 
associated with the module being 
described on this line. Under MVT f 
the type of the contents directory 
entry (CDE) associated with the module 
is given. The type may be either 
MAJOR or MINOR. Under MFT, the type 
is shown as either a loaded request 
block (LRB) or a loaded program 
request block (LPRB). 
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MODULE IMDSA9MP DATE 


11/12/70 TIME 00.15 PAG C 0001 




* * 


* * 


LINK 


PACK AREA MAP *** 


* 


NAME 


EPA 


STA 


LNGH 


TYPE 




IEELWAIT 


072418 


072418 


0C03E8 


MAJOR 




IGG0209Z 


C748C0 


C74800 


000400 


MAJOR 




IGG0201Z 


C74C00 


C74C00 


000400 


MAJOR 




IGG0201Y 


C75000 


C75000 


000400 


MAJOR 




IGGC200Z 


C75400 


C75400 


000400 


MAJOR 




IGG0200Y 


C75800 


C75800 


000400 


MAJOR 




IGG0200H 


C75C00 


C75CC0 


000400 


MAJOR 




IGG0200G 


076000 


C760C0 


000400 


MAJOR 




IGG0200F 


076400 


0764C0 


000400 


MAJOR 




IGG0200A 


C76800 


076800 


000400 


MAJOR 




IGG0199M 


076C00 


076C00 


000400 


MAJOR 




IGG0196B 


C77000 


077000 


000400 


MAJOR 




IGG0196A 


C77400 


C77400 


000400 


MAJOR 




IGG01917 


C77800 


C778C0 


000400 


MAJOR 




IGG019I1 


C77C00 


077C00 


G 00400 


MAJOR 




IGG01910 


C78000 


078000 


C00400 


MAJOR 




IGG01910 


C78400 


C78400 


000400 


MAJOR 




IGG0191G 


C78800 


C78800 


000400 


MAJOR 




IGG0191D 


C78C0C 


C78C00 


000400 


MAJOR 




IGGC191B 


C79000 


G79000 


000400 


MAJOR 




IGGC191A 


C79400 


C 79400 


000400 


MAJOR 




IGG0190S 


C79800 


C79800 


000400 


MAJOR 




IGG0190N 


079C00 


C79C00 


000400 


MAJOR 




IGG0190M 


C7A000 


C7A000 


000400 


MAJOR 




IGG0190L 


C7A400 


C7A400 


000400 


MAJOR 




IGC0005E 


C7A800 


C7A800 


000400 


MAJOR 




IGCC002 


C7AC00 


C7AC00 


000400 


MAJOR 




IGCC001I 


C7B360 


C7B360 


C00400 


MAJOR 




IGG019CK 


C7CAO0 


C7CA00 


000060 


MAJOR 




IGG019BC 


C7CA6C 


C7CA6C 


0000E8 


MAJOR 




IGG019BD 


C7CB48 


C7CB48 


000128 


MAJOR 




IGG019AD 


C7CC70 


C7CC70 


OOOOCO 


MAJOR 




IGG019AL 


C7CD30 


07CD30 


000158 


MAJOR 




IGP019AC 


C 70848 


07D848 


0000E8 


MAJOR 




IGG019CA 


C70930 


C 70930 


000088 


MAJOR 




IGG019CB 


C7D9B8 


C7D9B8 


000098 


MAJOR 




IGG019AG 


C70A50 


C7DA50 


000090 


MAJOR 




IGG019BE 


C7CAE0 


C7DAE0 


000188 


MAJOR 




IGG019AM 


C7DC68 


07DC68 


000078 


MAJOR 




IGG019AN 


C7DCE0 


C7DCE0 


00OOD8 


MAJOR 




IGG019AV 


C7DDB8 


C7DDB8 


000058 


MAJOR 




IGG019M0 


07DE10 


C7DE10 


OOOOFO 


MAJOR 




IGG019MB 


07B760 


07B760 


0010A0 


MAJOR 




IGG019MA 


C7CE88 


07CE88 


000978 


MAJOR 




IGG019CL 


C7E820 


07E820 


000040 


MAJOR 




IGG019CF 


C70F00 


C7DFC0 


000100 


MAJOR 




IGG019CE 


07E038 


07E038 


000088 


MAJOR 




IGG019AJ 


C7E0C0 


07E0C0 


000120 


MAJOR 




IGG019AI 


C7E1E0 


C7E1E0 


000080 


MAJOR 




IGG019BB 


C7E86C 


C7E860 


00C058 


MAJOR 




IGG019BA 


C7E260 


C7E260 


000180 


MAJOR 





Figure 21. Link Pack Area Map Sample 
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MODULF IMDSADMP DATE 11/12/70 TIME 00.15 



°AGE 0029 



JOB J0B4 



TCB 020400 



STEP GO 



PR0CSTEP STEP1 



***** CURRENT TASK ***** 



RBP 0002E410 PIE 00000000 
MSS 0002E770 PK-FLG FCOOOOOO 

RG 0-7 OCOOOOCO C000C066 

RG 8-15 0C020FA0 OOOCOOOO 

FSA 0006BF68 TCB OOCOOOOO 

LTC 00000000 IQE OOOOCOOO 

STA CCOCCOOO TCT 0002CF28 



DEB 0002DABC 

FLG 00001B1B 
0002DFBC 00000000 
0002DFC8 0005DF08 

TME 00000000 

ECB 0002DFC4 



TIO 0002E1F0 

LLS 0C02E3E0 

0002D660 

400 5DE56 

JST 0002D400 

TSPR 00000000 



USR 00000000 DAR 00000000 



CMP 00000000 TRN 00000000 

JLB 00000000 JPQ 0002E3E8 
0002D1E8 0002E234 0002DBA8 
0005DF08 6007F060 60008342 

NTC 00000000 OTC 0002D1E8 
D-POE 0002E770 SQS 0002DA90 

RES 00000000 JSCB 0002E33C 



ACTIVE RBS 

PRB 02E410 RESV OCOOOCOO APSW 00000000 WC-SZ-STAB 00040082 PL-CDE 0002E5E8 
Q/TTR 00000000 HT-LNK 0002D400 NM GO EPA 05DE50 STA 05DE50 



PSW FFF50009 AC05DEF8 
LN 0001B0 ATR1 OB 



MAIN STORAGE 
D-POE 0002E770 
PQE 02E688 



FIRST 0002E688 LAST 0002E688 



FFB 00C5ECC0 
TCB 0002D1E8 



LFB CCC5E000 
RSI COOOFOOO 



NPQ 00000000 
RAD 0005D800 



PPQ 00000000 
FLG 0000 



LOAD 


LIST 






























CDE 


02E3E8 


NM 


RETURNS 


USE 


01 


RESP 


01 


ATR1 


OB 


EPA 


05DDC8 


STA 


05DDC8 


LN 


000088 


CDE 


02BB50 


NM 


IGG019CC 


USE 


03 


PESP 


01 


ATR1 


BO 


EPA 


07E928 


STA 


07E928 


LN 


0000D8 


CDE 


02BB20 


NM 


IGG019CH 


LSE 


03 


RESP 


01 


ATR1 


BO 


EPA 


07E8B8 


STA 


07E8B8 


LN 


000070 


CDE 


02B730 


NM 


IGG019AC 


LSE 


02 


RESP 


01 


ATR1 


BO 


EPA 


07D848 


STA 


07D848 


LN 


0000E8 


CDE 


02BBF0 


NM 


IGG019AQ 


USE 


03 


RESP 


01 


ATR1 


BO 


EPA 


07F020 


STA 


07F020 


LN 


000078 



JOB PACK QUEUE 



CDE 
CDE 



02E3E8 
02E5E8 



NM RETURNS 
NM GO 



USE 01 
USE 01 



RESP NA 
RESP NA 



ATR1 OB 
ATR1 OB 



EPA 05DDC8 
EPA 05DE50 



STA 5DDC8 
STA 05DE50 



LN 000088 
LN 0001BC 



DEB 02DABC 



APPENDAGES END OF EXT 07E8B8 SIO 00OD72 PCI 000D72 CH END 000D72 AB END 000D72 
PFX OOCOOOOO C5000006 00010BE0 11000000 

TCB 0402D400 NDEB 1CC00C00 ASYN F8000000 SPRG 00000000 UPRG 0106BE18 PLST 1B000000 
AVT 0402CA98 

FM-UCB START END TRKS 
580026AC 00020003 C0C20003 0001 



DCB FF05DFA0 



TIOT 02E1F0 JOB J0B4 

OFFSET 
0018 
002C 



STEP GO PROC STEP1 

LN-STA CONAME TTR-STC STB-UCB 

14040101 PGM=*.DD 00271500 800026AC 

140401G1 DUMMY 00271900 800026AC 



Figure 22. Sample of MVT Major Control Block Format 



MAJOR SYSTEM CONTROL BLOCK FORMATS 



Formatting of the major system control 
blocks associated with a task is a function 
of either a FORMAT control statement, or 
one of the several noted parameters 
associated with the PRINT control 
statement. The control blocks of several 
tasks may be printed during one execution 
of IMDPRDMP. When more than one task is 
printed, the associated task control blocks 
(TCBs) are grouped into a TCB summary, 
listed following the printing of all 
requested tasks. This summary provides an 
index to the formatted TCBs by jobname. 
See the discussion "Task Control Block 
Summaries . " 

For ease of identifying various dump 
printouts, specific headings are printed on 
each dump; such as FORMAT, DAR AND F03 
TASKS, PRINT CURRENT, and PRINT JOBNAME. 

Each task being printed begins on a new 
page, identified by two heading lines. The 
first heading line contains the optional 
title supplied by the user, the name of the 
module that invoked the dump, and the date 
and time that the information was gathered 
from the dumped system, and a page number. 
The second line of the heading identifies 
the particular task being printed. This 
task information is broken down into the 
following named fields: 

JOB cccccccc 

The JOB field displays the 
eight-character name that was 
specified in the label field of the 
JOB statement. 

STEP cccccccc 

The STEP field shows the eight- 
character step name of the problem 
program associated with the task being 
dumped. This name was supplied in the 
label field of the EXEC statement. 

PROCSTEP cccccccc 

If the job step being displayed was 
invoked from a cataloged procedure, 
the step name of the cataloged 
procedure, as contained in the 
cataloged procedure's EXEC statement, 
is displayed in this field. 

If the task being printed was in control 
at the time the dump was taken, a third 
heading line follows the two previously 
described. The line "**** CURRENT TASK 



****" identifies the TCB associated with 
the task in control when the, dump was 
taken. 

While formatting the dumped control 
blocks, IMDPRDMP may issue various output 
comments to assist the person who analyzes 
the printout. The output comments are 
discussed following the control block 
discussion. 

Specific formatting of the major system 
control blocks is dependent upon the 
operating system option under which the 
dumped system was operating. To allow the 
reader to concentrate on the particular 
operating system with which he is 
concerned, the discussion of control block 
formatting is divided into three parts: 
MVT, MFT, and the TSO option of MVT. 



MVT Control Block Formatting 



The formats described below are repeated 
for each requested task that is printed. A 
sample of the major system control blocks, 
as formatted from an MVT dump, is shown in 
Figure 22. 

MVT TASK CONTROL BLOCK (TCB) FORMATTING : 
The task control block (TCB) contains 
information that pertains to the specific 
task named in the heading lines that appear 
at the top of the page. Each TCB is 
formatted as follows : 

TCB hhhhhh 

The address of the task control block 
being displayed is given in this first 
field. 

RBP hhhhhhhh 

The address of the request block (RB) 
that was currently associated with the 
task represented by this TCB. 

PIE hhhhhhhh 

The address of the first program 
interrupt element (PIE) enqueued by 
this TCB. 

DEB hhhhhhhh 

The address of the beginning of the 
data extent block (DEB) queue that was 
associated with this task. 
Information on the contents of each 
DEB in the queue is given in a 
separate portion of this MVT dump 
listing. 
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TIO hhhhhhhh 

The address of the task input output 
table (TIOT) that was constructed 
during device allocation for the task 
represented by this TCB. The contents 
of this table are displayed in a later 
portion of this task's display. 



CMP hhhhhhh 

This word contains ABEND indicators 
and user and system completion codes. 
The usage of this field is as follows: 



byte 
1.™ 

.1. 



.XX xxxx 



Bit indicates that a 

dump had been requested. 

Bit 1 set indicates that 

a step ABEND had been 

requested. 

Bits 2 through 7 are 

reserved for future use. 



bytes 1-3 

The first 12 bits contain a system 
completion code. These codes and 
their meanings are explained in the 
publication IBM System/360 Operating 
System: Messages and Codes , GC2 8-6631 
under the heading "System Completion 
Codes." A user completion code is 
contained in the last 12 bits. 

TRN hhhhhhhh 

Contains flags and TESTRAN indicators 
as follows: 



byte 

1... 



.1.. ... 



..1. 



...1 ... 



.... x. . . 
.1. . 



Bit set indicates that 

both TESTRAN and decimal 

simulator programs were 

being used on a 

System/360 Model 91 

machine. 

Bit 1 set indicates that 

checkpoints were not 

taken for this step. 

Bit 2 set indicates that 

the TCB being displayed 

belonged to either a 

graphics foreground or 

the graphic job 

processor. 

Bit 3 set indicates that 

the TCB being displayed 

was associated with a 

7094 emulator task that 

was being run on a 

System/360 Model 85 

machine. 

Bit 4 is reserved for 

future use. 

Bit 5 set indicates that 

this is a time shared 

task under control of 

the TEST command 

processor. 



,1. Bit 6 set indicates that 
the OLTEP functions 
require cleanup before 
abnormal termination can 
be invoked. 

,.x Bit 7 is reserved for 
future use. 



bytes 1-3 

The address of the control core table 
that was used by TESTRAN. 

MSS hhhhhhhh 

Main storage supervision information 
as follows: 

byte 

This byte determined roll-out 
eligibility for the job step 
associated with this TCB. 

00 in this byte indicated that the job 
step may be rolled out. 

nz (nonzero) in this byte indicated 
that the job step may not be rolled 
out. 

bytes 1-3 

These bytes contain the starting 
address of the last subpool queue 
element (SPQE) . 

PK-FLG hhhhhhhh 

The storage protection key of the task 
and a series of flags. This word is 
divided into several subfields. These 
are: 



byte 
xxxx 



.... 0000 

byte 1 

1... 



.1.. 



• • X • • * • • 






l... 



The storage protection 
key of the task 
represented by this TCB. 
Always contain zeros. 



Bit set indicates 
thatan abnormal 
termination was in 
progress at the time the 
dump was taken. 
Bit 1 set indicates that 
a normal termination was 
in progress at the time 
the dump was taken. 
Bit 2 set causes the 
Erase routine in ABEND 
to enter when ABEND is 
in control again. 
Bit 3 set causes the 
Purge routine in ABEND 
to enter when ABEND is 
in control again. 
Bit 4 set indicates that 
the Graphics Abnormal 
Termination routine was 
in control of the task 
associated with this TCB 
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at the time the dump was 
taken. Bit 7 in byte 3 
of this word must also 
be on. 

.... .1. . Bit 5 set indicate s that 
the top task in the TCB 
chain (usually the job 
step TCB) was in the 
process of being 
terminated when the dump 
was taken. 

.... ..1. Bit 6 set indicates that 

an abnormal dump has 
been completed. 

...» ... 1 Bit 7 indicates that 

asynchronous exits could 
not be scheduled. 

byte 2 

1... .... Bit set indicates that 

the SYSABEND (or 
SYSUDUMP) data set for 
the job step is being 
opened. Operands of 
ABEND macro instruction 
have been saved in 
TCBCMP field. 

.1.. .... Bit 1 set indicates that 

if this is an initiator 
TCB, the second job step 
interval has expired. 

..1. .... Bit 2 set indicates that 
for a job step TCB, the 
job step can cause 
rollout. 

...1 .... Bit 3 set indicates that 
the current task had a 
forced completion 
imposed upon it. Other 
tasks in the system 
could not have been 
performed until the 
current task had been 
completed. 

.... 1... Bit 4 set indicates that 
the job step had a 
forced completion 
imposed upon it. Other 
tasks in the job step 
could not have been 
performed until the 
present job step had 
been completed. 

.... .1.. Bit 5 set indicates that 
the SYSABEND (or 
SYSuDUMP) data set has 
been opened for the job 
step. 

.... ..1. Bit 6 set indicates that 

an EXTR exit was 
requested by an 
attaching task. 

.... ...1 Bit 7 set indicates that 

the task associated with 
this TCB was a member of 
a time- sliced group. 



byte 3 

1 Bit set indicates that 

a PSW associated with 
the task represented by 
this TCB was in the 
supervisor state. 

.1.. .... Bit 1 set is applicable 

to job step TCBs. 
Setting of this bit 
indicates that the job 
step had invoked 
rollouts that were still 
in effect at the time 
the dump was taken. 

..1. .... Bit 2 set indicates that 
ABEND was processing in 
such a manner as to 
prevent multiple ABENDS 
from occurring in the 
dumped system. 

...1 ...x Bit 3 set indicates that 
the SYSABEND (or 
SYSUDUMP) data set is 
being opened by this 
task. (See also bit 7.) 

.... l..x Bit 4 set indicates that 
an ABDUMP was in process 
for the task associated 
with this TCB at the 
time the dump was taken. 
(See bit 7 of this 
byte. ) 

1.. Bit 5 set is applicable 

only for job step TCBs. 
With this bit set, no 
abnormal termination 
dumps could have been 
provided within the job 
step represented by this 
TCB. 

.lx Bit 6 set indicates that 

a CLOSE had been issued 
during ABEND processing. 
(See bit 7 of this 
byte.) 

...x x.xl Bit 7 set, in 

conjunction with bits 3, 
4, or 6 of this byte or 
bit 4 in byte 1 of this 
word indicates that, had 
the dumped system been 
allowed to continue 
processing without 
interruption by the 
IMDSADMP dump program, a 
valid reentry to ABEND 
would have been 
effected. 

FLG hhhhhhhh 

This field displays a further series 
of flags and certain priority 
indicators. This word is divided into 
subfields as follows: 
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byte 

If any one of the flags comprising 
this byte were set at the time the 
dump was taken, the task represented 
by this TCB was considered to be 
non-dispatchable . 



1... 
. x . . 

..1. 






Bit was set by ABDUMP 

Bit 1 is reserved for 

future use. 

Bit 2 set indicate s that 

the supply of I/O 

request queue elements 

(RQEs) had been 

exhausted. 

Bits 3 through 5 are 

reserved for future use. 

...... 1. Bit 6 is applicable only 

to M65 multiprocessing 
situations. The setting 
of this bit indicates 
that the task 
represented by this TCB 
had been flagged 
non-dispatchable by one 
CPU to prevent any CPU 
from working on it. 

.... ...1 Bit 7 set indicates that 

the task associated with 
this TCB entered the 
ABEND routine while the 
data control block 
representing the 
SYSABEND data set was 
being opened for another 
task. 

byte 1 

If any one of the flags comprising 
this byte were set at the time the 
dump was taken, the task represented 
by this TCB was considered to be 
non-dispatchable. 



1 . . . 



.1.. 



...1 



Bit set indicates that 
the task represented by 
this TCB was terminated 
prior to the time the 
dump was taken. 
Bit 1 set indicates that 
the task represented by 
this TCB was a candidate 
for termination by 
ABEND. 

Bit 2 set indicates that 
a routine of the task 
represented by this TCB 
issued an unconditional 
GETMAIN that could only 
have been satisfied by 
the rolling out of 
another job step. 
Bit 3 indicates that the 
job step associated with 
this TCB was rolled out. 
Bit 4 set indicates that 
another task was in 
system-must-complete 
status. 



.... .1. . Bit 5 set indicates that 
another task in this job 
step was in 
step-must- complete 
status at the time the 
dump was taken. 

.... ..1. Bit 6 is applicable only 

for an initiator task. 
Setting of this bit 
indicates that a request 
for a region could not 
be satisfied. 

.... ...1 Bit 7 is the primary 

non-dispatchability 
indicator. Setting of 
this bit indicates that 
one or more of the 
secondary 

non-dispatchability bits 
(bytes 1-3 of the DAR 
field) was set at the 
time the dump was taken. 

byte 2 

The dispatching priority limit for the 
task represented by this TCB. 

byte 3 

The dispatching priority of the task 
represented by this TCB. 

LLS hhhhhhhh 

The load list element (LLE) for the 
program that was loaded by means of 
the LOAD macro instruction. 

JLB hhhhhhhh 

The address of the data control block 
associated with the JOBLIB associated 
with the task. 

JPQ hhhhhhhh 

Contains information pertaining to a 
job step TCB as follows: 



byte 
1. 



.XXX xxxx 



Bit set indicates that 
if the associated job 
step had been allowed to 
continue processing 
without being 
interrupted by the dump 
program, the job step 
would have been purged. 
Bits 1 through 7 are 
reserved for future use. 



bytes 1-3 

The address of the last contents 
directory entry for a job pack area 
(JPA) control queue. 

RG 0-7 and RG 8-15 

The register save area of the TCB 
being displayed. The general 
registers were stored in this area 
upon entry to the first routine 
invoked in the task. On entry to any 
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task, register 13 points to this TCB's 
register save area. This pointer is 
useful in locating the entry points of 
first routines and in tracing the save 
area chains. 



FSA hhhhhhhh 

The address of the first problem 
program save area. 

TCB hhhhhhhh 

The address of the TCB that had the 
next lowest priority on the ready 
queue at the time the dump was taken. 

TME hhhhhhhh 

The address of the timer element. 

JST hhhhhhhh 

The address of the first TCB for a job 
step. For tasks with a storage 
protection key of zero (as shown in 
the first byte of the PK-FLG field) , 
this word contains the address of this 
TCB. 

NTC hhhhhhhh 

The address of the previous TCB that 
existed on the originating task's 
queue of subtask TCBs (sister). If 
this TCB was the first on the queue, 
this field contains zeros. 

OTC hhhhhhhh 

The address of the TCB representing 
the originating task (mother) . 

LTC hhhhhhhh 

The address of the last TCB that 
existed on the originating task's 
queue of subtask TCBs at the time the 
dump was taken (daughter). If this 
TCB was the last on the queue, this 
field contains zeros. 

IQE hhhhhhhh 

The address of the interruption queue 
element (IQE) that was used in 
scheduling the EXTR routine on the 
originating task. 

ECB hhhhhhhh 

The address of the event control block 
(ECB) that would have been posted by 
the supervisor's task termination 
routines had either normal or abnormal 
task termination been allowed to 
occur. 

TSPR hhhhhhhh 

byte 

This field contains flags that 
indicate the status of the time 
sharing (TSO) . Without TSO or when 
TSO has not been started, this field 
contains zeros. 



1... .... Bit set indicates that 

this task is a time sharing 
task. 

.1.. .... Bit 1 set indicates that the 

time sharing task should be 
set non-dis pat enable. This 
bit was set by the TCBSTP 
routine while the routine 
was not executing as a 
privileged program. 

-.1. .... Bit 2 set indicates that the 
system is executing and 
requires that the time 
sharing task must not be 
interrupted by the attention 
exit or by the STATUS SVC. 

...1 .... Bit 3 set indicates that a 
terminal I/O purge is 
required. 

.... xxxx Bits H through 7 are 

reserved for future use. 

byte 1 

This field contains the number of SET 
STATUS starts required to make this 
time sharing task dispatchable. 

byte 2 

This field contains the limit priority 
of the time sharing task. 

byte 3 

This field contains the dispatching 
priority of the time sharing task. 

D-PQE hhhhhhhh 

The address of the region dummy 
partition queue element minus 8 
(DPQE-8 ) . 

SQS hhhhhhhh 

The address of an allocated queue 
element (AQE) which contains the 
amount of available bytes assigned to 
this task in the system queue area 
(SQA) , and a pointer to the next AQE 
for this task. 

STA hhhhhhhh 

Internal STAE routine flags and the 
address of the STAE control block that 
was in effect at the time the dump was 
taken. 

TCT hhhhhhhh 

This word contains information 
pertaining to the dumped system's 
timing control table (TCT) . The TCT 
field is divided into the following 
two subfields: 

byte 

Reserved for future use. 
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bytes 1-3 

If the system management facilities 
option was present in the dumped 
system, these bytes contain the 
address of the dumped system's timing 
control table. 

USR hhhhhhhh 

This word is available to the user of 
the dumped system. It contains any 
information placed in it by the user. 

DAR hhhhhhhh 

The contents of this field were used 
by the damage assessment routines 
(DAR). Certain subfields displayed in 
this word were also used to control 
the dispatchability of the dumped 
task. The DAR field is divided into 
the following subfields: 

byte 

The first byte of the DAR field 
contains DAR flags. These flags are 
as follows: 

1... .... Bit set indicates that 

primary DAR recursion 
occurred in the dumped 
system. The damage 
assessment routine 
failed while writing a 
main storage image dump. 
.1.. ..... Bit 1 set indicates that 

secondary DAR recursion 
occurred in the dumped 
system. The damage 
assessment routine 
failed while attempting 
to reinstate a failing 
region or partition. 
..xx .... Bits 2 and 3 are 

reserved for future use. 
.... 1... Bit 4 set indicates that 

the system error task is 
failing. The DAR dump 
should not request any 
error recovery procedure 
(ERP) processing. 
.... . xx. Bits 5 and 6 are 

reserved for future use. 
.... ...1 Bit 7 set indicates that 

an SVC dump is executing 
for this task, 
byte 1 

Bytes 1 through 3 of the DAR field are 
used to store secondary 
non-dispatchability flags. If any of 
the flag bits in this subfield were 
set, the primary non-dispatchability 
bit (the last bit in the FLG field) 
will also have been non-dispatchable. 
The bit settings that may appear in 
byte 1 are as follows: 

xx.. .... Bits and 1 are set by 

the damage assessment 
routines. Their 
meanings are: 



1... 



i X « • 



• . xx 



..1. 



X. 



.1. 



.XX 



Bit set indicates that 
the task represented by 
this TCB is temporarily 
non-dis patchable . 
Bit 1 set indicates that 
the task represented by 
this TCB is permanently 
non-dis patchable . 
Bits 2 and 3 are 
recovery management 
support and system error 
recovery flags. Their 
meanings are; 
Bit 2 set indicates that 
the task represented by 
this TCB is temporarily 
non-dis pat chable . 
Bit 3 set indicates that 
the task represented by 
the TCB is permanently 
non-dis patchable . 
Bit 4 is reserved for 
future use. 

Bit 5 set indicates that 
this task is temporarily 
non-dispatchable. Timer 
services have been 
requested and the 
time-of-day clock is 
still inoperative. 
Bits 6 and 7 are 
reserved for future use. 



byte 2 

The bit settings for byte 2 
follows: 



are as 



x. . 



.1. 



.1. 



1. 



.1. 



XX 



Bit is reserved for 

future use. 

Bit 1 set indicates that 

this task has been 

stopped by a STATUS 

stop. 

Bit 2 set indicates that 

task is 

non-dispatchable. An 

SVC dump is executing 

for another task. 

Bit 3 set indicates that 

this task is being 

swapped out by the time 

sharing (TSO) . 

Bit 4 set indicates that 

this task is in an input 

wait state. 

Bit 5 set indicates that 

this task is in an 

output wait state. 

Bits 6 and 7 are 

reserved for future use. 



byte 3 

Reserved for future use. 

RES hhhhhhhh 

Reserved for future use. 
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JSCB hhhhhhhh 

The address of the job step control 
block. 



MVT ACTIVE REQUEST BLOCK (RB) FORMATTING ; 
Request blocks (RBs) were used by the lines 
at the top of the dump page and in the 
preceding TCB display, are listed in the 
portion of the dump listing labeled "ACTIVE 
RBS." Information on each RB associated 
with the task is formatted as shown below: 

PRB 

IRB hhhhhh 

SVRB 

SIRB 

Each RB display is preceded by a field 
that indicates the type and address of 
the RB being displayed. The four 
types of RBs that may be displayed 
under an MVT task are: 



PRB 



IRB 



SVRB 



program request block 



interruption request block 



supervisor request block (SVRBs 
may be divided into two 
categories; type 2 for resident 
routines and type 3 or 4 for 
transient routines) 



SIRB 



system interruption request 
block. 



The type acronym for each RB is 
displayed in the first portion of the 
field. The starting address of the 
indicated request block appears in the 
last portion of the field. The 
contents of certain fields in the body 
of the formatted display are dependent 
upon the type of RB being displayed. 
Variations in display field usage are 
noted in the descriptions of the 
fields in which they occur. 

RESV 

TAB-LN hhhhhhhh 

FL-PSA 

This field shows both the function and 
the first word of the request block 
being displayed. The meanings of the 
function indicators and the values 
that follow them are: 



RESV 



indicates that the request block 
is either a PRB or an SVRB for 
resident routines. The first 
word of these particular RBs is 
reserved for future use and 
contains zeros. 



TAB-LN 

indicates that the request block 
being displayed is used as an 
SVRB for transient routines. The 
value field is divided into two 
subfields of two bytes each. The 
first two bytes show the 
displacement of the entry point 
of the module represented by this 
SVRB from the beginning of the 
transient area control table 
(TACT). The second subfield 
shows the length, in bytes, of 
the SVC routine, 

FL-PSA 

indicates that the RB being 
displayed is an IRB. The value 
portion of this field is divided 
into two subfields. The first 
subfield has a length of one byte 
and contains indicators for the 
timer routines. When there were 
no timer routines, this field 
contains zeros. The timer 
routine indicators set at the 
time the dump was taken are shown 
as: 



1... 
.1.. 
..00 

..01 

..11 



1. 



.000 



,100 



.001 



.011 



.111 



indicates that the 

timer element was not 

on queue. 

indicates that the 

local time-of-day 

option was used. 

indicates that the 

time interval was 

requested in timer 

units . 

indicates that the 

time interval was 

requested in binary 

units . 

indicates that the 

time interval was 

requested in decimal 

form. 

indicates that the 

time interval had 

expired. 

indicates a task 

request 

indicates a task 

request with an exit 

specified. 

indicates a wait 

request. 

indicates a real 

request. 

indicates a real 

request with an exit 

specified. 



The second subfield is three 
bytes long and contains the 
starting address of the problem 
program register save area (PSA) . 
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APSW hhhhhhhh 

The APSW field displays information 
pertaining to the program status word 
that was active at the time the dump 
was taken. The functional variations 
associated with the usage of this 
field are: 

• PRBs being formatted contain the 

right half (bytes 4 through 7) of 
the problem program's PSW when an 
ABTERM interruption occurred. 

■■•■■•■ IRBs, SIRBs, and SVRBs for resident 
routines use this field to display 
the right half (bytes 4 through 7) 
of the PSW that was active, in the 
dumped system, during the 
execution of an ABEND or ABTERM 
routine. If no ABEND or ABTERM 
routine was envoked in the dumped 
system, this field contains zeros. 

• SVRBs for transient routines use 

this field in much the same way as 
SVRBs for resident routines. If 
an ABEND or ABTERM routine was 
invoked in the dumped system, 
bytes 4 through 7 of the 
associated PSW are displayed in 
this field. If an ABEND or ABTERM 
routine was not invoked, this 
field contains the last four 
characters of the name of the 
requested routine. (The last two 
characters of the name represent 
the SVC number. ) 

WC-SZ-tSTAB hhhhhhhh 

This field contains information 
pertaining to wait conditions, request 
block sizes,, and RB status and 
attribute characteristics. This field 
is divided into three subfields, as 
follows: 

byte 

The wait count that was in effect at 
the time of the dump. 

byte 1 

The size of this request block. This 
RB size is expressed as the number of 
doublewords comprising the block. 

byte 2 

The last two bytes of the WC-SZ-STAB 
field contain bit settings that 
reflect the status and attributes of 
the request block. The settings that 
may appear in byte 2 are: 

xx. . . . . . Bits and 1 indicate 

the type of RB being 
displayed. The possible 
settings for these two 
bits and their meanings 
are: 



00.. .... This is a program 

request block (PRB),. 

01. . .... This is an interrupt 

request block (IRB). 

10,.. .... This is a system 

interrupt request block 
(SIRB) . 

11.. .... This is a supervisor 

request block (SVRB) . 

..x. x.xx Bits 2, 4, 6 and 7 are 

reserved for future use. 

...1 .... Bit 3 set indicates that 
this request block is an 
SVRB for a transient 
routine. 

.... .1.. Bit 5 is applicable only 
if the request block 
being displayed is an 
SVRB. If this bit is 
set, a checkpoint could 
have been taken in a 
user exit from the SVC 
routine associated with 
this RB. 



byte 3 

The last byte of the WC-SZ-STAB field 
contains more status and attribute 
flags. The possible settings for this 
subfield and their meanings are: 

1... .... Bit set indicates that 

the WT-LNK field in this 
RB display, contains in 
its last three bytes, 
the address of the TCB 
to which this request 
block is linked. 

.1.. .... Bit 1 applies only to 

IRBs and SIRBs. If this 
bit is set, the 
indication is that at 
the time the dump was 
taken, the program 
associated with this RB 
was active. 

..x. .... Bit 2 is reserved for 
future use. 

...1 .... Bit 3 is applicable only 
to IRBs. The setting of 
this bit is an 
indication that the IRB 
was associated with an 
ETXR exit routine. 

.... xx. . Bits 4 and 5 concern 
interruption queue 
elements (IQEs) and 
request queue elements 
(RQEs). This flag is 
used as follows: 

.... 00.. This setting indicates 
that the request queue 
element was not to be 
returned to the free 
list when the exit was 
taken. 
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01. « This setting indicates 
that the IRB had queue 
elements for 
asynchronously executed 
routines that were RQEs. 
This setting is 
applicable only if the 
RB being displayed is an 
IRB. 

10.. This setting indicates 
that the IQE was not to 
have been returned at 
EXIT. 

11.. This setting is 

applicable only to IRBs. 
If this setting appears,, 
the indication is that 
the IRB had queue 
elements for 
asynchronously executed 
routines that were IQEs. 

,. .1. Bit 6 set indicates that 
request block storage 
could be freed at the 
time of exit. 

...x Bit 7 indicates request 
wait conditions. The 
meanings of the two 
possible settings for 
this bit are: 

...0 Bit 7 not set indicates 
that the request had to 
wait for a single event 
or all of a number of 
events. 

... .1 Bit 7 set indicates that 
the request had to wait 
for a number of events. 
This number of events 
was less than the total 
number of events that 
were waiting. 



EPA 



.... .1. . indicates that a SYNC 

macro instruction was 

requested. 
.... . .1. indicates that an 

XCTL macro 

instruction was 

requested. 
.... ...1 indicates that a LOAD 

macro instruction was 

requested. 

The second subfield is three 
bytes long and contains the 
address of the contents directory 
entry (CDE) representing the 
module that this request block 
was associated with. 



The request block being displayed 
is an IRB. The value field 
contains the entry point address 
of a routine that was 
asynchronously executed. 



TQN 

The request block being displayed 
represents a transient routine 
SVRB. The value field contains 
the address of the next request 
block that was on the queue of 
transient routines. 

PSW hhhhhhhh hhhhhhhh 

The resume program status word. This 
PSW represents the status of the 
program represented by the RB being 
displayed when a new RB was created. 
Had the dumped system been allowed to 
continue processing without being 
interrupted by the dump program, 
operation would have resumed on this 
PSW. 



FL-CDE 

EPA 

TQN 



hhhhhhhh 



This field shows both the function and 
the fourth word of the request block 
being displayed. The meaning of the 
function indicator and the value 
following it is given below: 

FL-CDE 

the request block being displayed 
is either a PRB or an SVRB for a 
resident routine. The value 
field is divided into two 
elements. The first subfield has 
a length of one byte and contains 
control flag settings. 

These control flags are as 
follows : 

xxxx x... Bits through 1 are 
reserved for future 
use. 



Q/TTR hhhhhhhh 

This word is used to display various 
data, depending upon the type of 
request block being displayed. Usage 
of the Q/TTR value field is used by 
each type of request block as follows: 

• PRBs and SVRBs that represented 
resident routines do not use this 
field; the first byte always 
contains zeros. Bytes 1 through 3 
of the field show the address of a 
request block that requested the use 
of the same serially reusable 
program. 

• IRBs utilize this field in one of 
two ways, to show either the 
three-byte link-field segment or the 
two-byte link-field segment, 
depending upon the IRB usage. The 
three -byte link-field segment 
appears in the Q/TTR value field as 
follows: 
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byte 

Contains a count of the number of 
requests for the same exit (ETXR). 
This use count is utilized by the 
ATTACH macro instruction. 

byte 1-3 

Contains the starting address of 
the queue of interruption queue 
elements ( IQEs ) ,. 

Alternately, the Q/TTR value field 
may be formatted to show the 
two-byte link-field segment. In 
this instance, the field is used 
thusly: 

byte 0-1 

Reserved for future use. 

bytes 2-3 

The starting address of the queue 
of request queue elements (RQEs) . 

SVRBs that represented transient 
routines display two data elements 
in this field. The first subfield 
has a length of one byte and shows 
the number of requests if the 
transient routine was overlaid. The 
last three bytes of the Q/TTR field 
contain the relative direct access 
device address for the associated 
supervisor routine in the form TTR. 



WT-LNK hhhhhhhh 

This field displays information 
pertaining to wait counts and request 
block linkages. In the case of a 
transient SVC, if this field contains 
x^F" , either the routine represented 
by the SVRB is currently being brought 
into the transient area, or this 
routine has been displaced in the 
transient area by a routine requested 
by a higher priority task. To tell 
what has happened, compare the APSW 
and NM field contents as described 
under NM below. This field is divided 
into two subfields, one with a length 
of one byte and the other with a 
length of three bytes. These 
subfields show the following: 

byte 

The number of requests that were 
pending at the time the dump was taken 
(wait count). 

byte 1-3 

The address of the next request block 
on the RB queue. In the last RB on 
the queue, this field contains the 
address of the task control block 
(TCB) . 



NM cccccccc 

The eight character name of the load 
module represented by the request 
block being displayed with a possible 
exception for transient SVRBs. 

If byte of the WT-LNK field contains 
x'FF* , it is possible that the module 
represented by this SVRB has been 
overlaid in the transient area by a 
module requested by a higher priority 
task. Compare the APSW field, 
(providing it contains the four 
low-order bytes of a module name) with 
the last four characters (the 
hexadecimal should be translated to 
EBCDIC) of the module name in the NM 
field. No match indicates the user of 
the transient area has been pre-empted 
by a higher priority task. NM 
therefore represents the module 
currently in the transient area, not 
the module represented by this SVRB,. 

If a match results, NM correctly 
identifies the module name requested 
by this SVRB. 

EPA hhhhhh 

The address of the entry point of the 
module named in the NM field of this 
RB display. 

STA hhhhhh 

The starting address of the module 
identified in the NM field of this 
RB"s display. 

LN hhhhhh 

The length, in bytes, of the load 
module that is represented by this 
request block. 

ATR1 hh 

This one byte field displays the 
attributes of the described module. 
These attributes are taken from the 
contents directory entry associated 
with the module. The meanings of the 
attribute flag settings are given 
below: 



1. 



.1 



,1. 



.1 



Bit set indicates that 
the module was resident 
in the link pack area. 
Bit 1 set indicates that 
at the time the dump was 
taken, the module 
represented by this 
request block was in the 
process of being 
fetched. 

Bit 2 set indicates that 
the module was 
reenterable. 

Bit 3 set indicates that 
the module was serially 
reusable. 
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1. . . Bit 4 set indicates that 
the module could not 
have been reused. This 
f lag setting is not 
applicable if either bit 
2 or 3 is set. 

. 1. . Bit 5 set indicates that 
the contents directory 
entry associated with 
this module reflects the 
use of an alias name. 
This information applies 
only to minor CDEs. 

..1. Bit 6 set indicates that 
the module was in the 
job pack area. 

...1 Bit 7 set indicates that 
the module was 
considered not 
only- loadable . 



MVT MAIN STORAGE INFORMATION ; Each task 
operating under the MVT option of the 
operating system was dynamically assigned a 
region of main storage that consisted of 
one or more 2K-byte subpool areas. To keep 
track of main storage allocations, the MVT 
supervisor maintained a partition queue 
associated with each region, Composed of 
partition queue elements (PQEs), and 
residing in the system queue area, this 
partition queue was connected to the TCBs 
for each task in a job step through a dummy 
partition queue element (DPQE). 

Information on the areas of main storage 
allocated to each task, is presented to the 
user in a separate portion of each task's 
dump listing headed "MAIN STORAGE." This 
main storage information is formatted as 
shown below: 

D-PQE hhhhhhhh 

The address minus eight bytes of the 
dummy partition queue element (DPQE- 8) 
connecting the partition queue to this 
task's TCB. 

FIRST hhhhhhhh 

The starting address of the first 
partition queue element (PQE) on this 
region's partition queue. 

LAST hhhhhhhh 

The starting address of the last PQE 
on the partition queue. 

PQE hhhhhh 

The starting address of one of the 
partition queue elements on the 
partition queue bounded by the 
addresses given on the line above. 

FFB hhhhhhhh 

The starting address of the first free 
block queue element (FBQE) on the free 
block queue associated with this PQE. 



If no FBQEs exist, this field contains 
the address of the PQE being displayed 

LFB hhhhhhhh 

The starting address of the last free 
block queue element (FBQE) on the free 
block queue associated with this PQE. 
If no FBQEs exist, this field shows 
the starting address of this PQE. 

NPQ hhhhhhhh 

The starting address of the next 
partition queue element on the 
partition queue. If the PQE being 
displayed was the last PQE on the 
queue, this field contains zeros. 

PPQ hhhhhhhh 

The starting address of the partition 
queue element on the partition queue 
that preceded this PQE. If this PQE 
was the first on the queue, this field 
contains zeros. 

TCB hhhhhhhh 

The starting address of the TCB of the 
job step to which the described region 
is assigned. If this field contains 
zeros, the indication is that the area 
of main storage was obtained from 
unassigned free space. 

RSI hhhhhhhh 

The size of the region being 
described. This number is a multiple 
of 2K (20U8). 

RAD hhhhhhhh 

The starting address of the region 
being described by this PQE. 

FLG hhh 

The FLG field shows the settings of 
several PQE flags whose meanings are 
given below: 

x. . . ... . Bit indicates region 

ownership. The meanings 
of the settings are: 

0. ... ..... indicates that the space 

described by this PQE 
was owned by the 
associated task. 

1... .... indicates that the space 

described by this PQE 
was borrowed. 

.1.. .... The setting of bit 1 is 

meaningful only if bit 
was not set. If this 
bit is set and bit is 
not set, the indication 
is that the region had 
been rolled out. 

. .1. .... Bit 2 set indicates that 
the region described by 
this PQE was borrowed by 
another task. 

,...x xxxx Bits 3 through 7 are 

reserved for future use. 
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MVT LOAD LIST FORMATTING ; A load list was 
maintained by the dumped system's 
supervisor in order to keep track of the 
load modules that were in main storage and 
the area of main storage each occupied. 
The load list maintained by a system 
operating under the MVT option of the 
operating system contained a series of load 
list elements (LLEs) , each of which was 
associated with a particular load module 
through the use of a control block called a 
contents directory entry (CDE) , A 
formatted listing of the dumped system's 
MVT load list appears as follows: 



CDE hhhhhh 

The starting address of the contents 
directory entry associated with this 
load list item. 

NM cccccccc 

The eight-character name of the entry 
point to the load module represented 
by this entry. 

USE hh 

The count of the number of uses 
(through the ATTACH, LINK and XCTL 
macro instructions) of the load 
module, and the number of times a LOAD 
macro instruction was issued for the 
module. 

RESP hh 

The responsibility count contained in 
the load list entry associated with 
the load module. This count indicates 
the number of requests made by the 
LOAD macro instruction for the 
indicated load module. This count was 
decremented by one for each occurrence 
of the DELETE macro instruction. 



.... 1... Bit 4 set indicates that 
the load module could 
not have been reused. 
This flag setting is not 
applicable if either bit 
2 or 3 is set. 

.... .1.. Bit 5 set indicates that 
the contents directory 
entry associated with 
this load module 
reflects the use of an 
alias name. If this bit 
is set, this line of the 
load list display 
reflects information 
taken from a minor CDE. 

.... ..1. Bit 6 set indicates that 

the load module was in 
the job pack area. 

.... ...1 Bit 7 set indicates that 

the load module was 
considered not 
only-loadable. 

EPA hhhhhh 

The address of the entry point of the 
load module named in the NM field of 
this load list display line.. 



STA hhhhhh 

This field contains the starting 
address of the load module identified 
in the NM field of this load list 
display line. 

LN hhhhhh 

The LN field supplies the user with 
the length, in bytes, of the load 
module represented by this load list 
entry (LLE) . 



ATR1 hh 

The attributes of the load module 
described in this load list entry. 
These attributes are taken from the 
contents directory entry associated 
with the module. The meanings of the 
attribute flag settings are given 
below: 



1. 



..1. 



* <• <• JL 



Bit set indicates that 
the module was resident 
in the link pack area. 
Bit 1 set indicates that 
at the time the dump was 
taken, the load module 
represented by this load 
list element was in the 
process of being loaded. 
Bit 2 set indicates that 
the load module was 
reenterable. 

Bit 3 set indicates that 
the load module was 
serially reusable. 



MVT JOB PACK QUEUE FORMAT : A job pack area 
control queue (JPACQ) exists for each job 
step in the dumped system that used a 
program not in the link pack area. The job 
pack queue, like the link pack area, is 
made up of contents directory entries 
(CDEs). This area describes routines in a 
job step region that were brought into main 
storage by contents supervision routines to 
perform a task in the job step. The 
IMDPRDMP program displays the contents of 
the dumped MVT system* s job pack queue as 
follows: 

CDE hhhhhh 

The starting address of the contents 
directory entry associated with this 
job pack queue element. 



NM cccccccc 

The eight-character name of the entry 
point to the load module represented 
by this entry. 
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USE hh 

The count of the number of uses 
(through the ATTACH, LINK and XCTL 
macro instructions) of the load 
module, and the number of times a LOAD 
macro instruction was issued for the 
module. 

RESP NA 

This responsibility count field is 
flagged 'NA 1 to indicate that the 
information is not applicable to 
modules displayed in the job pack 
queue.. 

ATR1 hh 

The attributes of the load module 
described in this job pack queue 
entry. These attributes are taken 
from the contents directory entry 
associated with the module. The 
meanings of the attribute flag 
settings are: 

1... .... Bit set indicates that 

the module was resident 
in the link pack area. 

.1.. .... Bit 1 set indicates that 

at the time the dump was 
taken, the load module 
represented by this job 
pack queue entry was in 
the process of being 
loaded. 

..1. .... Bit 2 set indicates that 
the load module was 
reenterable. 

...1 .... Bit 3 set indicates that 
the load module was 
serially reusable. 

.... 1... Bit 4 set indicates that 
the load module could 
not have been reused. 
This flag setting is not 
applicable if either bit 
2 or 3 is set. 

.... .1.. Bit 5 set indicates that 
the contents directory 
entry associated with 
this load module 
reflects the use of an 
alias name. If this bit 
is set, this line of the 
job pack queue display 
reflects information 
taken from a minor CDE. 

1. Bit 6 set indicates that 

the load module was in 
the job pack queue area. 

.... ...1 Bit 7 set indicates that 

the load module was 
considered not 
only- loadable. 

EPA hhhhhh 

The address of the entry point of the 
load module named in the NM field of 
this job pack queue entry display 
line. 



STA hhhhhh 

This field contains the starting 
address of the load module identified 
in the NM field of this job pack queue 
entry display line. 

LN hhhhhh 

The LN field supplies the user with 
the length, in bytes, of the load 
module represented by this job pack 
queue entry. 

MVT DATA EXTENT BLOCK (DEB) FORMATTING ; 
Data extent blocks (DEBs), describing a 
data set's external storage requirements, 
were queued to those task control blocks 
(TCBs) that represented tasks requiring 
auxiliary storage input/ output processing. 
External storage information, taken from 
each DEB, is formatted as shown below: 

DEB hhhhhh 

The starting address of the basic 
section of the DEB being displayed. 

APPENDAGES 

The word "appendages" informs the user 
that the five named fields on this 
line contain information taken from 
the appendage vector table preceding 
the DEB being displayed. The named 
fields appearing on the rest of this 
line are: 

END OF EXT hhhhhh 

The entry point of the end- of- extent 
appendage routine. 

SIO hhhhhh 

The entry point of the start I/O 
appendage routine. 

PCI hhhhhh 

The entry point of the 
program-controlled-interruption 
appendage routine. 

CH END hhhhhh 

The entry point of the channel-end 
appendage routine. 

AB END hhhhhh 

The entry point of the abnormal-end 
appendage routine. 

PFX hhhhhhhh hhhhhhhh hhhhhhhh 

The second line of a DEB display 
contains information taken from the 
prefix section of the DEB being 
displayed. The area is subdivided as 
follows : 

byte 

The first byte of the prefix area 
contain the contents of the I/O 
support work area. This area is used 
only by DEBs dealing with direct 
access storage devices. 
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bytes 1-7 

The next seven bytes of the DEB prefix 
section are used by DEBs associated 
with direct access storage device 
functions. This subfield displays the 
data set control block's (DSCB) 
address used by I/O support. The 
address is expressed in the following 
format : 

bytes 1 and 2 the bin (cell) number, 
bytes 3 and 4 the cylinder address, 
bytes 5 and 6 the track address, 
byte 7 the record number. 

bytes 8-11 

The third word of the PFX field 
contains the data control block (DCB) 
modification mask that was used by I/O 
support. 

byte 12 

The length of the DEB in doublewords . 

bytes 13-15 

The remainder of the DEB prefix 
section is reserved for future use. 

TCB hhhhhh 

This field marks the beginning of the 
basic section of the data extent 
block. The TCB field is divided into 
two subfields as follows: 

byte 

The number of subroutines for which a 
LOAD macro instruction was issued 
during the execution of the OPEN 
executor routines. 

bytes 1-3 

The starting address of the task 
control block to which this DEB was 
enqueued. 

NDEB hhhhhh 

The NDEB field is also used to display 
two data elements. It is subfielded 
as follows: 

byte 

The overall length of a data extent 
block includes the length of a 
variable length access method 
dependent section. The first byte of 
the NDEB field, expresses the length 
of the access method dependent section 
in bytes. If the access method was 
BDAM, this indicator is expressed as a 
number of fullwords. 

bytes 1-3 

The last portion of the NDEB field 
displays the starting address Of the 
basic section of the next DEB on the 
task's queue. If this DEB was the 
last on the queue, the contents of 
this field are the starting address of 
the TCB that enqueued this DEB. 



ASYN hhhhhhhh 

This field contains *ata set status 
flags and the address of the 
associated IRB. This field is used as 
follows: 

byte 

The first byte of the ASYN field 
contains data set status flags. These 
flags have the following meanings: 



xx. . 

01.. 
10.. 

11.. 
..1. 



1. 



.1.. 



..1. 



Bits and 1 indicate 
the data set's 
disposition. The 
possible settings are: 
This setting indicates 
that the disposition was 
OLD. 

This setting indicates 
that the disposition of 
the data set was MOD 
(modify) . 

This setting indicates 
that the disposition was 
NEW. 

Bit 2 set indicates that 
an end- of -volume (EOV) 
or end-of-file (EOF) 
condition had been 
encountered. 

The setting of bit 3 has 
one of two meanings 
depending upon the 
external storage medium. 
For disk this indicator 
reflects a release of 
unused external storage. 
For tape, the meaning of 
this indicator is that 
an emulator tape with 
second generation format 
was being used. 
Bit 4 set is a data 
control block (DCB) 
modification indicator. 
Bit 5 set has two 
meanings, depending upon 
the auxiliary storage 
recording medium. For 
disk, the setting of bit 
5 indicates that a split 
cylinder was 
encountered. For tape, 
this flag indicates that 
an emulator tape with 
possible mixed parity 
records was used. 
Bit 6 set indicates the 
use of nonstandard 
labels. 

Bit 7 set indicates that 
reduced error recovery 
procedures were used on 
magnetic tapes 
containing the data set 
represented by this DEB. 
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bytes 1-3 

The last portion of the ASYN field 
shows the starting address of the IRB 
that was associated with asynchronous 
appendage exit scheduling. 

SPRG hhhhhhhh 

This field contains information on I/O 
processing methods and the system 
PURGE routine. The usage of this 
field is as follows: 

byte 

The first byte of this field contain 
flags that indicate the method of 
input/output processing and the 
disposition of the data set that was 
to have been performed when an end-of- 
volume condition occurred. These flag 
settings are: 



1, . . 


.... 


Bit was set by ABEND. 
The setting of this bit 
indicates that the data 
set associated with this 
DEB was a SYSABEND or 
SYSUDUMP data set. 


.0,. 


.... 


Bit 1 is always zero. 


. .XX 




Bits 2 and 3 show the 
end-of- volume 
disposition procedure. 
The values for this flag 
are: 


..01 


..... 


REREAD 


. . 11 


. .. • • 


LEAVE 




xxxx 


The last half of this 
byte contains flags that 
indicate the type of 
input/output processing 
that was performed on 
the data set represented 
by this DEB. The values 
for this flag are: 


• .. • • 


0000 


INPUT 


• ,.... 


1111 


OUTPUT 


■ • • . 


0011 


INOUT 


.... 


0111 


OUTIN 


• • • • 


0001 


RDBACK 


.... 


0100 


UPDAT 



byte 1 

The quiesce count. The byte is 
associated with the system PURGE 
routines (SVC 16) and indicates the 
number of auxiliary storage devices 
that were executing the user's channel 
programs . 

bytes 2-3 

Reserved for future use. 

UPRG hhhhhhhh 

The UPRG field contains extent 
information and data used by the 
user's purge routines. This field is 
divided into the following two 
subf ields : 



byte 

The number of extents that were 
specified in the DSCBs associated with 
this DEB. 

bytes 1-3 

The address of the first input/ out put 
block (IOB) in the user's purge chain. 

PLST hhhhhhhh 

Task priority and supervisor purge 
information are contained in this 
field. This field is formatted as 
follows : 

byte 

The priority of the task under which 
this DEB was enqueued. 

bytes 1-3 

The starting address of a parameter 
list that was used to locate the purge 
event control block (ECB) for a 
supervisor purge request. 

DCB hhhhhhhh 

The DCB field contains three data 
elements. These are displayed in the 
format given below: 



byte 
xxxx 



.... The storage protection 
key that was associated 
with the task under 
which this DEB was 
enqueued. 

1111 A hexadecimal 'F* in 

bits 4 through 7 of this 
field identify this 
control block as a data 
extent block (DEB) . 



bytes 1-3 

The starting address of the data 
control block (DCB) that was 
associated with this DEB. 

AVT hhhhhhhh 

The AVT field displays two DEB data 
elements and is subfielded as follows: 

byte 

The DEB extent scale that is used to 
determine the size of the device 
dependent section of this DEB. For 
direct access devices, a 4 is 
displayed in this subfield. For a 
nondirect access device or a 
communication device, a 2 is 
displayed. 

bytes 1-3 

In most cases the last portion of the 
AVT field shows the starting address 
of the appendage vector table 
preceding this DEB. This table of 
appendage routine addresses appears on 
the first line of this DEB's display. 
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OP-UCB hhhhhhh 

The contents of this field have 
meaning only when the DEB being 
displayed describes a data set that 
was assigned to a unit record or 
magnetic tape device. This 
information is formatted from the 
device dependent section of the DEB. 
The OP-UCB field is subfielded as 
follows : 

byte 

This first subfield is applicable only 
to data sets assigned to magnetic tape 
devices and shows the SET MODE 
operation code. For a data set that 
was assigned to a unit record device, 
this subfield is reserved. 

bytes 1-3 

The starting address of the unit 
control block (UCB) associated with 
the data set described by the DEB 
being displayed. 

The following four fields are present only 
for data sets assigned to the IBM 3525 Card 
Punch for multi-function. The information 
is formatted as shown below: 

UCB hhhhhhhh 

byte 

The device modifier field (not used 
for the 3525) . 

bytes 1-3 

The starting address of the unit 
control block (UCB) associated with 
the data set described by the DEB 
being displayed. 

RDRDCB hhhhhhhh 

The starting address of the data 
control block (DCB) for the read 
associated data set. 

PCHDCB hhhhhhhh 

The starting address of the data 
control block (DCB) for the punch 
associated data set. 

WTRDCB hhhhhhhh 

The starting address of the data 
control block (DCB) for the print 
associated data set. 

Tne final portion of a DEB display shows 
information pertaining to a data set that 
was assigned to a direct access device. 
This information,, taken from the DEB's 
device dependent section, is arranged in 
columnar format with a line for each 
extent. The information is formatted as 
shown below: 

FM-UCB hhhhhhhh 

The first column displays two data 
elements and is formatted as follows: 



byte 

The device modifier showing the file 
mask. 

bytes 1-3 

The starting address of the unit 
control block (UCB) that was 
associated with the data extent. 

START hhhhhhhh 

The address of the beginning of the 
direct access device extent- The 
first four characters represent the 
cylinder address and the last four 
characters represent the track 
address . 

END hhhhhhhh 

The address of the end of the data 
extent. Cylinder and track references 
are formatted as in the extent 
beginning address, described above. 

TRKS hhhh 

The number of direct access tracks 
bounded by the starting and ending 
addresses shown in the previous two 
columns. 

MVT TASK INPUT/OUTPUT TABLE (TIOT) 
FORMATTING : A task input output table 
(TIOT) was constructed for each task in the 
dumped system by MVT job management 
routines. Residing in the system queue 
area, this table contained primary pointers 
to control blocks used by I/O support 
routines. As the functions of several TIOT 
fields were dependent upon the state of 
associated external storage devices, 
multiple definitions may apply. The TIOT 
that was constructed in an MVT system is 
formatted as shown. 

TIOT hhhhhh 

The starting address of the task 
input/output table being displayed. 

JOB cccccccc 

The eight-character name of the job 
for which this TIOT was constructed. 

STEP cccccccc 

The eight-character name specified in 
the label field of the EXEC JCL 
statement associated with this job 
step. 

PROC cccccccc 

If the job step for which this TIOT 
was constructed was invoked from a 
cataloged procedure, the procedure 
name, as contained in the EXEC JCL 
statement, is displayed in this field. 

Each data set associated with the indicated 
task is represented by a separate DD entry 
that is included in the TIOT. Each TIOT 
entry is displayed on a separate line in 
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columnar format. The use and meaning of 
each column is given below: 

OFFSET hhhh 

The offset of this DD entry from the 
beginning of the TIOT in hexadecimal. 

LN-STA hhhhhhhh 

Four bytes of length and status 
information, described below: 

byte 

The total length (including all device 
entries) in bytes of the DD entry 
being displayed on this line. 

byte 1 

Status byte A, one of three status 
bytes in a TIOT entry. The meanings 
of the status byte settings are: 

x... .x.. Bits and 5 indicate 
the tape label 
processing that was to 
have been performed. 
The meanings of the 
settings are: 
Nonlabeled tape or an 
indication to bypass 
label processing. 
Standard labels and 
standard user labels. 
Nonstandard labels. 
The setting of status 
bit 1 has two meanings, 
depending upon the 
processing phase that 
had been reached at the 
time the system was 
dumped. During 
allocation processing, 
the setting of this bit 
indicates that this 
entry represents a split 
cylinder primary space 
allocation DD. If the 
dump was taken during 
step termination 
processing, the setting 
of this bit indicated 
that no unallocation of 
space was necessary. 
1. .... The setting of status 
bit 2 works under the 
same philosophy as 
status bit 1. During 
allocation processing, 
the setting of this bit 
indicates that this 
entry represents a split 
cylinder secondary space 
allocation DD. If the 
dump was taken during 
step termination 
processing, the 
indication was one of 
rewinding with no 
unload. 



0... . .0. 



0... .1.. 

1... .0.. 
.1,. 



..1 .... Bit 3 set indicates that 
this DD entry represents 
a JOBLIB. 

... 1... Bit 4 set indicates that 
direct access device 
space management was 
deemed necessary. 

... ..1. The setting of bit 6 

specifies that the tape 
volume was to have been 
rewound and unloaded. 

... ...1 The setting of bit 7 

specifies that the tape 
volume was to have been 
rewound. 



byte 2 

The third byte of this column has 
meaning only during the allocation 
phase. This displays the number of 
devices that were requested by the 
data set represented by the TIOT entry 
displayed on this line. 



byte 3 

The last byte of the LN-STA field 
displays a TIOT field that had meaning 
at two points during the processing of 
this task. During the allocation 
process, this field contained a link 
to the appropriate prime split, unit 
affinity, volume affinity or 
suballocate TIOT entry. After CLOSE 
processing, this byte was used thusly: 



•XXX xxxx 



The setting of bit 
indicates that the data 
set represented by this 
DD entry was a SYSODT 
data set that contained 
data. 

Bits 1 through 7 are 
reserved for future use. 



DDNAME cccccccc 

The eight-character DD name associated 
with the TIOT entry being displayed. 



TTR-STC hhhhhhhh 

The first three bytes of this column 
display the relative track address 
(TTR) of the job file control block 
(JFCB) associated with this entry. 



STB-UCB hhhhhhhh 

The last column in a TIOT display 
contains information taken from the 
one -word device entries that are 
appended to each TIOT entry. One TIOT 
device entry exists for each allocated 
device. This display field shows this 
information in the following format: 
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byte 

Status byte B. The status bits have 
the following meanings: 



1. 



...1 






Bit set indicates that 
the data set associated 
with this line of the 
TIOT display was present 
on the device 
represented by this TIOT 
device entry. 
Bit 1 set indicates that 
the data set associated 
with this line of the 
TIOT display would have 
used the device 
represented by this TIOT 
device entry. 
Bit 2 set indicates that 
the device represented 
by this device entry 
violated separation. 
Bit 3 set indicates that 
a volume serial number 
was present. 

Bit 4 set indicates that 
a setup message was 
required. 

Bit 5 indicates the 
device disposition that 
would have taken place 
had the dumped system 
been allowed to continue 
processing this task. 
The settings for this 
bit are: 

Indicates that if the 
volume was required to 
be unloaded, the volume 
was to have been 
deleted. 

Indicates that if the 
volume was requires to 
be unloaded, the 
unloaded volume was to 
have been retained. 
Bit 6 indicates that an 
unload requirement had 
been made. 

Bit 7 set indicates that 
a load or label 
verification requirement 
had been made. 



bytes 1-3 

The address of the UCB that was used 
in all cases except when the device 
was a 2321 data cell drive. For a 
2321, this address is that of the 
description in the UCB of the cell in 
the bin. 

MFT Control Block Formatting 

The formats described below are repeated 
for each requested task that is printed. A 
sample of the major system control blocks, 
as formatted from an MFT dump, is shown in 
Figure 23. 



.0. 



.1. 



.1. 



... 1 



MFT TASK CONTROL BLOCK <TCB) FORMATTING : 
The task control block (TCB) contains 
information pertaining to the specific task 
identified in the heading lines at the top 
of the dump listing page. It is formatted 
as follows: 



TCB hhhhhh 

The address of the task control block 
being displayed is given in this first 
display field. 

RBP hhhhhhhh 

The starting address of the request 
block (RB) that was currently 
associated with the task represented 
by this TCB. 

PIE hhhhhhhh 

The address of the first program 
interrupt element (PIE) enqueued by 
this TCB. 

DEB hhhhhhhh 

The address of the beginning of the 
data extent block (DEB) queue that was 
associated with this task. 
Information on the contents of each 
DEB in the queue is given in a 
separate portion of this MFT task's 
dump listing. 

TIO hhhhhhhh 

The starting address of the task 
input/output table (TIOT) that was 
constructed during device allocation 
for the task represented by this TCB. 
The contents of this table are 
displayed in a later portion of this 
task*s display. 

CMP hhhhhhhh 

This word contains ABEND indicators 
and user and system completion codes 
as follows: 



byte 
1... 



.1.. . 



,1. .. 



... x 



Bit set indicates that 
a dump had been 
requested. 

Bit 1 is reserved for 
future use but is set 
for MVT compatibility. 
Bit 2 set indicates that 
a portion of the problem 
program's main storage 
area was overlaid by a 
second load of ABEND. 
A first load overlay is 
indicated by the setting 
of bit 14 of the PK-FLG 
field. 

Bit 3 is reserved for 
future use. 

Bit 4 set indicates that 
a double ABEND occurred 
in the dumped task. 
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MFT DUMP LISTING 



rtJJJLc IMDSADMP DATE 11/12/70 TIME 00.50 



PAGE 0011 



JOB J0B5 



TCB 009148 



STEP GO 



PROCSTEP STEP1 



***** CURRENT TASK ***** 



RiiP 000C9228 

MSS 00009210 

RG 10-1 000717B0 

RG 2-9 00000000 

FSA 08071730 TCB 

LTo GCGoCOOO IQE 

STA CCJCOOJO TCT 



PIE 00000000 
PK-FLG 10000008 



0C02A910 
0002C304 
00009348 
00000000 
000209A8 



DEB 00071634 TIO 00 071728 
FLG 000001E3 LLS 000712F8 
5002A826 9BC71260 4002A896 
0007176C 0000004C 00009148 
TME 00009228 PIB E0019AB8 
ECB OCCOOOOC XTCB 00000000 
USR 00000000 CAR OOOCOOOO 



CMP OCOOOOOG TRN COCCCOCO 

JLB COOOOOOC JST 00CC9148 
50007FD2 CCCOCOCC 000C011A 
000717F8 0CC71778 OOOCOOOO 

NTC OOOOOCCC CTC OOCOCOCO 
LP/FL E300000C RES 00000000 

RES COOOOCOC JSCB 00021284 



ACTIVE RBS 

PRa 02A800 NM GO 



SZ/STAB OC2C00C0 USE/EP 0002A820 PSrf FF150G80 9002A€7A Q 00000000 hT-LNK OOC09148 



IRB 009228 NM *GKO ARY SZ/STAB 0C0E404C USE/EP G002A87E PSW FF150193 8002A8AA Q CCCC9288 

RG 10-1 FA00C048 00009228 00000000 0002C304 J007176C 000C0C4C 0C009148 C00717F8 

RG 2-9 00071778 COOOOOOO 000717B0 0C02A910 5002A826 0CO2A91O 13C0C0CC 4C0122EA 

EXTSA 00000000 000712B0 00C09228 00009148 

P/P BOUNDrtlES 

HicR 0002A30U TO 00071800 HI ER 1 OOCOOOOO TO 00000000 



UT-LNK CCC2A800 



LOAD LIST 



LRB 071300 NM DUM>1YuL 
LPRB 071390 NM RETURNS 



JOB PACK QUEUE 
YOFHING IN JOB PACK 



SZ CC0088 
SZ C000A8 



USE/EP 01071310 
USE/EP 010713B0 



DEB 07163* 



DEB 07150C 



APPENDAGES END CF EXT 0229CO SIO 003FF4 PCI 003FF4 CH END CC3FF4 AB END 003FF4 

PFX OCJCGGOO 05C00005 00010BE0 11000000 

TLB 04009148 NOEB 1007150C ASYN F8CC0OOO SPrtG OOGOJOOO UPRG C107144C 

AVT 0407x010 

FM-UCB START END TRKS 

5800156C 00020C03 00020C03 0001 

APPtNDAGES END OF EXT 0138F0 SIO 013922 PCI 0136F8 CH END 013864 AB END C13922 

PFX OOOOCOOO 05C00007 000007EO OFOOOOOO 

TCB CCU0S148 NDEB OCOOOOOO ASYN A8000000 SPRG UOOOOGOO UPRG 010C0CCC PLST E3CC0COO 
Ai/T 040136E4 

FM-UCd START END , TRKS 

5d0015EC OOC40003 0CC50009 0011 



PLST E3CC0C00 CCB 1F02A8B0 



CCB 0F071778 



TIOT 071728 JOB JOB 5 STEP GO 

OFFSET LN-STA DDNAME 

0018 14040100 PGM=*.DD 

002C 14040100 DUMMY 



PRHC STEP1 

TTR-STC STb-UCB 

007D0CC0 800015EC 

007F0300 8000156C 






Figure 23. Sample of MFT Control Block Format 



CMP hhhhhhhh — byte — (continued) 

.... .1.. Bit 5 set indicates that 

a dump message (WTO) was 
to have been issued. 
.... . . 1. Bit 6 set indicate s that 

the dumped system ' s 
scheduler was to have 
printed an indicative 
dump. 
.... ...1 Bit 7 set indicates that 

an ABEND message, to be 
printed by the ABDUMP 
routine, was provided. 

bytes 1-3 

The first 12 bits contain a system 
completion code. These codes and 
their meanings are explained in the 
publication IBM System/360 Operating 
System; Messages and Codes , GC2 8-6631 
under the heading "System Completion 
Messages." A user completion code is 
contained in the last 12 bits. 

TRN hhhhhhhh 

Contains flags as follows: 

byte 

1..,. .... Bit set indicates that 
decimal simulator 
programs were being used 
on a System/360 model 91 
machine. 

.1.. .... Bit 1 set indicates that 

checkpoints were not 
taken for this step. 

. . 1 . .... Bit 2 set indicate s that 
the TCB being displayed 
was associated with 
either a graphics 
foreground job or the 
graphic job processor. 

...1 .... Bit 3 set indicates that 
the TCB being displayed 
was associated with a 
7094 emulator task that 
was being run on a 
System/360 model 85 
machine. 

.... xxxx Bits 4 through 7 are 

reserved for future use. 

bytes 1-3 
Reserved. 

MSS hhhhhhhh 

Main storage supervision as follows: 

byte 

This byte is reserved for future use. 

bytes 1-3 

This subfield displays one of two 
addresses. If the TCB being displayed 
represents a job step, this subfield 
contains the address of the boundary 
box. If this TCB represents a 



sub task, this field displays the 
address of the gotten queue element 
(GQE). GQEs are preset only if the 
dumped system issued a GETMAIN macro 
instruction for the space. 

PK-FLG hhhhhhhh 

The storage protection key and a 
series of flags associated with the 
task being displayed. This field is 
divided into several subfields. These 
are: 



byte 
xxxx 



0000 



byte 1 
1. 



.1.. 



.1, 



...1 



. 1... 



.1. 



..1. 



... 1 



byte 2 
1. 



The storage protection 

key associated with the 

task represented by this 

TCB. 

Always contain zeros. 



Bit set indicates that 
an abnormal termination 
was in progress at the 
time the dump was taken. 
Bit 1 set indicates that 
a normal termination was 
in progress at the time 
the dump was taken. 
Bit 2 set indicates that 
ABEND was initiated by 
the resident abnormal 
termination routine. 
Bit 3 set indicates that 
recursion through ABEND 
was permitted. 
Bit 4 set indicates that 
the graphics abnormal 
termination routine had 
been entered for the 
task represented by the 
TCB being displayed. 
Bit 5 set indicates that 
the CLOSE routine was 
initiated by ABEND. 
Bit 6 set indicates that 
a portion of the problem 
program* s main storage 
area was overlaid in 
order to process ABEND 
routines. (See also bit 
2 of the CMP display 
field.) 

Bit 7 set indicates that 
the queueing of 
asynchronous exits for 
the task represented by 
the TCB being displayed, 
was prohibited. 

Bit set indicates that 
ABEND was prohibited for 
this task. The setting 
of this bit has meaning 
only if the TCB being 
displayed represents a 
system task. 
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.xx. ..x. Bits 1, 2 and 6 are 

reserved for future use. 

...1 . .,. . Bit 3 set indicates that 
the task represented by 
the TCB being displayed 
had a forced completion 
imposed upon it. Other 
tasks in the dumped 
system could not have 
been performed until 
this task had been 
completed. 

.... 1... Bit 4 set indicates that 
the job step had a 
forced completion 
imposed upon it. Other 
tasks in the dumped 
system could not have 
been performed until 
this job step had been 
completed. 

.... .1.. Bit 5 indicates that 

dump processing had been 
initiated in ABEND. 

.... ...1 Bit 7 set indicates that 

the task represented by 
the TCB being displayed 
was a member of a time 
sliced group. 

Bits 0, 1, 3 and 7 are 
reserved for future use. 
Bit 2 is an exit 
effector indicator. The 
setting of this bit 
indicates that at the 
time the dump was taken, 
system error routines 
were operating on this 
task. 

.... 1... Bit 4 set indicates that 
floating point registers 
existed in the dumped 
system. 

.... .1.. Bit 5 set indicates that 
at the time the dump was 
taken, job scheduler 
routines were 
processing. 

.... ..1. Bit 6 set indicates that 

at the time the dump was 
taken, an XCTL routine 
was changing the storage 
protection key in the 
PSW from zero to the one 
used by the problem 
program. 

FLG hhhhhhhh 

This field displays a further series 
of flags and certain priority 
indicators. This word is formatted as 
follows: 

byte 

Reserved for future use. 



byte 3 

XX. X . 

.,1. . 



byte 1 

xxxx xxx. Bits through 6 are 

reserved for future use. 
.... ... 1 Bit 7 is the primary 

non-dis patchability 
indicator. Setting of 
this bit indicates that 
one or more of the 
secondary 

non-dis patchability bits 
(bytes 1-3 of the DAR 
field) was set at the 
time the dump was taken. 
If this bit is set, the 
task represented by this 
TCB was considered to be 
non-dis patchable . 

byte 2 

This byte contains the number of 
resources for which the task 
represented by this TCB was enqueued. 

byte 3 

This byte displays the dispatching 
priority of the task represented by 
this TCB. 



LLS hhhhhhhh 

The address of the last request block 
(RB) that was created by the loading 
of a module that used the LOAD macro 
instruction. 

JLB hhhhhhhh 

The address of the data control block 
(DCB) representing the JOBLIB 
associated with this task. 

JST hhhhhhhh 

Job step information. The contents of 
this field have meaning only when the 
dumped MPT system was operating with 
the sub tasking option. If this was 
the case, this field shows the address 
of the first TCB for a job step. 

RG 0-7 and RG 8-15 

The register save area of the TCB 
being displayed. This pointer is 
useful in locating the entry points of 
first routines and in tracing the save 
area chains.. 



FSA hhhhhhhh 

This field displays two data elements 
and is formatted as follows: 

byte 

The TCB identification code. 

byte 1-3 

The address of the first problem 
program save area. 
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TCB hhhhhhhh 

The address of the TCB that had the 
next lowest priority on the ready 
queue at the time the dump was taken. 

TME hhhhhhhh 

The address of the timer element. 

PIB hhhhhhhh 

The PIB field displays two items of 
information in the following format: 

byte 

This byte contains flags that identify 
the partition attributes- These flags 
are: 

xx. . .... Bits and 1 indicate 

the function of the 
partition. The possible 
functions are given 
below: 

00.. .... System task partition. 

01.. .... Reader partition. 

10-,. .... Writer partition. 

11.. .... Processing program 

partition. 

..x. .... Bit 2 gives the 

partition size. The 
meanings of the possible 
settings are: 

. . . .... Small partition. 

. . 1. . . ,. . Large partition. 

...1 .... Bit 3 set indicates that 
CPU timing was stopped 
by FINCH until a 
transient routine was 
loaded. 

.... xx. . Bits 4 and 5 are 

reserved for future use. 

.... ... 1. Bit 6 set indicates that 

the partition associated 
with this task was a 
writer partition. This 
bit is used by ABEND, 
transient writers and 
resident writers. 

.... . . 1. Bit 7 set indicate s that 

at the time the system 
was dumped, the 
scheduler was in 
control. Had this 
task's TIOT been written 
to SYSl.SYSJOBQE, this 
bit would not be set. 

bytes 1-3 

The last portion of the PIB field 
shows the address of the partition 
information block (PIB) that was 
associated with this task's partition. 

NTC hhhhhhhh 

The address of the previous TCB that 
existed on the originating task • s 
queue of subtask TCBs ( sister) . If 
the TCB was the first on the queue, 
this field contains zeros. The 
contents of the NTC field have meaning 



only if the dumped system was 
operating with the MFT subtasking 
option. 

OTC hhhhhhhh 

The OTC field is applicable only when 
the dumped system was operating under 
MFT subtasking option. If this was 
the case, this field displays the 
address of the TCB representing the 
originating task (mother). 

LTC hhhhhhhh 

The address of the last TCB that 
existed on the originating task's 
queue of subtask TCBs (daughter) at 
the time the dump was taken. If this 
TCB was the last on the queue, this 
field contains zeros. This field is 
applicable only if the dumped system 
was operating under the MFT subtasking 
option. 

IQE hhhhhhhh 

The address of the interruption queue 
element (IQE) that was used in 
scheduling the ETXR routine on the 
originating task. The contents of 
this field have no meaning unless the 
dumped system was operating under the 
MFT subtasking option. 

ECB hhhhhhhh 

If the dumped system was operating 
under the MFT subtasking option, this 
field displays the address of the 
event control block (ECB) that would 
have been posted by the supervisor's 
task termination routines had either 
normal or abnormal task termination 
been allowed to occur. 

XTCB hhhhhhhh 

The XTCB field in this TCB display is 
reserved for future use. 

LP/FL hh hhhhhh 

Priority and dump information on tasks 
that were operating under the 
subtasking option of MFT. The LP/FL 
field displays its data as follows: 

byte 

The limit priority of the task 
represented by the TCB being 
displayed. 

byte 1 

Dump information flags. 



XXXX X. . . 



.1.. 



Bits through 4 are 
reserved for future use. 
Bit 5 set indicates that 
the task represented by 
the TCB being displayed 
was the top task in the 
tree of abnormally 
terminating tasks. 
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..1. Bit 6 set indicates that 
an abnormal termination 
dump had been completed. 

.. ... 1 Bit 7 set indicates that 
the task represented by 
this TCB was enqueued on 
a dump data set. 



byte 2 

This byte contains more dump 
information flag bits. The meanings 
of these bits are: 



1.. 



.XXX X. 



. 1. . 

. .X. 

..0. 
..1. 



Bit set indicates that 
at the time the system 
was dumped, an OPEN was 
in process for the dump 
data set. 

Bits 1 through 4 and bit 
7 are reserved for 
future use. 

Bit 5 set indicates that 
the dump data set was 
open for the job step. 
Bit 6 indicates the type 
of dump data set. The 
possible setting are: 
SYSUDUMP data set. 

SYSABEND data set. 



byte 1-3 

If the system management facilities 
option was presented in the dumped 
system, these bytes contain the 
address of the dumped system's timing 
control table (TCT) - 

USR hhhhhhhh 

This word is available to the user of 
the dumped system. It contains any 
information placed in it by the user. 

DAR hhhhhhhh 

The contents of this field were used 
by the damage assessment routine 
(DAR). Certain subfields displayed in 
this word were also used to control 
the dispatchability of the dumped 
task. The DAR field is divided into 
the following subfields. 

byte 

The first byte of the DAR field 
contains DAR flags. The flags are as 
follows: 



byte 3 

This last byte of the LP/FL field 
shows abnormal termination flags as 
follows : 

xxx. x.xx Bits 0, 1, 2, 4, 6 and 7 
are reserved for future 
use. 

... 1 .... Bit 3 set indicate s that 
a valid message 
recursion occurred in 
ABEND. 

.... .1.. Bit 5 set indicates that 
no abnormal termination 
dumps could be provided 
within the job step 
associated with the TCB 
being displayed. 

RES hhhhhhhh 

This field is reserved for future use. 

STA hhhhhhhh 

Internal STAE routine flags and the 
address of the STAE control block that 
was in effect at the time the dump was 
taken. 

TCT hhhhhhhh 

Information pertaining to the dumped 
system" s timing control table (TCT). 
The TCT field is divided into the 
following two subfields: 

byte 

This byte is reserved for future use. 



.1.. 



,1. 



.x 



1. 



.XX. 



...1 



Bit set indicates that 
primary DAR recursion 
occurred in the dumped 
system. The damage 

assessment routine 
failed while writing a 
main storage image dump. 
Bit 1 set indicates that 
secondary DAR recursion 
occurred in the dumped 
system. The damage 
assessment routine 
failed while attempting 
to reinstate a failing 
partition. 

Bit 2 set indicates that 
only the dump capability 
of the damage assessment 
routine was requested. 
Bit 3 is reserved for 
future use. 

Bit 1 set indicates that 
the system error task is 
failing. The DAR dump 
should not request any 
error recovery procedure 
(ERP) processing. 
Bits 5 and 6 are 
reserved for future use. 
Bit 7 set indicates that 
an SVC dump is executing 
for this task. 



byte 1 

Bytes 1 through 3 of the DAR display 
field are used to show the settings of 
secondary non-dispatchability flags 
bits. If any of the flags in this 
subfield were set, the primary 
non-dispatchability flag (the last bit 
in the FLG field) will also have been 
set and the task represented by this 
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TCB will have been non-dispatchable. 
The bit settings that may appear in 
byte 1 and their meanings are: 



3u£<« ■• * ' 



l... 



.1. 



. .XX 



..1. 



...1 



X. 



. .XX 



byte 2 

1 



.x.. ... 



X XXX. 



Bits and 1 were set by 

the damage assessment 

routines. Their 

meanings are: 

Bit set indicates that 

the task represented by 

the TCB being displayed 

was flagged temporarily 

non-dispatchable. 

Bit 1 set indicates that 

the task represented by 

this TCB was deemed 

permanently 

non-dispatchable. 

Bits 2 and 3 are 

recovery management 

support and system error 

recovery flags. Their 

meanings are: 

Bit 2 set indicates that 

the task represented by 

this TCB was flagged 

temporarily 

non-dispatchable. 

Bit 3 set indicates that 

the task represented by 

the TCB being displayed 

was deemed permanently 

non-dispatchable. 

Bit 4 is reserved for 

future use. 

Bit 5 set indicates that 

this task is temporarily 

non-dispatchable. Time 

services have been 

requested and the 

time- of -day clock is 

still inoperative. 

Bits 6 and 7 are 

reserved for future use. 



Bit indicates that at 
the time the dumped 
system was active, 
ABDUMP was processing. 
The setting of this flag 
bit has meaning only if 
the dumped system was 
operating with the 
subtasking option of 
MFT, 

Bit 1 is reserved for 
future use. 

Bit 2 set indicates that 
this task is 
non-dispatchable. An 
SVC dump is executing 
for another task. 
Bits 3 through 6 are 
reserved for future use. 



...1 Bit 7 set indicates that 
at the time the system 
was dumped, the dump 
data set was in the 
process of being opened. 



byte 3 
1.. 



The setting of this 
first bit has meaning 
only if the dumped 
system was operating 
with the MFT subtasking 
option. If this bit is 
set, the indication is 
that the task 
represented by the TCB 
being displayed was 
terminated. 

.1.. .... Bit 1 set indicates that 

had the dumped MFT 
system, operating with 
the subtasking option, 
been allowed to continue 
processing without 
intervention by the dump 
program, the task 
represented by this TCB 
would have been 
terminated by ABEND. 

..xx xxxx Bits 2 through 7 are 

reserved for future use. 

RES hhhhhhhh 

Reserved for future use. 

JSCB hhhhhhhh 

Contains the address of the job step 
control block. 

MFT ACTIVE REQUEST BLOCK (RB) FORMATTING : 
Request blocks (RBs) were used by the 
dumped system's supervisor to maintain 
information concerning a task. RBs 
associated with the task identified in the 
heading lines at the top of the dump page 
and in the preceding TCB display, are 
listed in the portion of the dump listing 
labeled "ACTIVE RBS". Information on each 
RB associated with the task is formatted as 
shown below: 

PRB 

LPRB 

SVRB hhhhhh 

SIRB 

IRB 

Each RB display is preceded by a field 
that indicates the type and starting 
address of the RB being displayed. 
The five types of RBs that may be 
displayed under an MFT task are: 



PRB 



LPRB 



program request block 



loaded program request block 
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SVRB 



supervisor request block (SVRBs 
may be divided into two 
categories; type 2 for resident 
routines and type 3 or U for 
transient routines). 



byte 2 

STAB flag bit settings. The meaning 
of these flags are depends upon the 
type of request block being displayed. 
These flags are presented, by RB type, 
below: 



SIRB 



IRB 



PRB 



system interrupt request block 



interruption request block 



The type acronym for each RB is 
displayed in the first portion of the 
field. The starting address of the 
indicated request block appears in the 
last portion of the field. The 
contents of certain fields in the body 
of the formatted RB display are 
dependent upon the type of RB being 
displayed. Variations in display 
field usage are noted in the 
descriptions of the fields in which 
they occur. 

NM cccccccc 

The variations associated with the 
usage of this field are: 

• PRBs and LPRBs use this field to 
display the name of the program they 
represented. 

• SVRBs display the SVRB type in this 
field. 

• SIRBs use this field to present the 
eight-character name of the error 
routine that was occupying the 
supervisor transient area at the 
time the dump was taken. 

• IRBs display meaningful information 
in this field only if the timer was 
being used. If this was the case, 
the first character in this field 
represents the setting of the timer 
flags. The remainder of the NM 
field is meaningless. 



SZ/STAB hhhhhhhh 

This field displays two data elements; 
RB size information and STAB flag bit 
settings. This field is subfielded as 
follows: 

bytes 0-1 

The number of contiguous doublewords 
that were occupied by the request 
block, the associated program (if 
applicable) , and associated supervisor 
work areas. If a program extent list 
was present, the program size is not 
included in this figure. 



LPRB 



The following bit settings are 
applicable to program request 
block displays : 

0000 .... indicates that the 

program represented 
by this PRB was not 
loaded by a LOAD 
macro instruction; 
nor did it have minor 
entries identified by 
an IDENTIFY macro 
instruction. 

0001 .... indicate that the 

program represented 
by this PRB was not 
loaded by a LOAD 
macro instruction but 
did have minor 
entries identified by 
an IDENTIFY macro 
instruction. 

.... xx. . Bit 4 and 5 have no 
meaning in PRB 
displays. 

.... ..1. indicates that the 

program represented 
by this PRB was 
hierarchy block 
loaded and that a 
program extent list 
existed. 

.... ... .1 indicates that the 

program module 
represented by this 
PRB was refreshable. 



Loaded program request blocks 
being displayed may have the 
following bit settings in this 
byte: 

0010 .... indicates that the 

program represented 
by this LPRB was not 
loaded by a LOAD 
macro instruction; 
nor did it have minor 
entries identified by 
an IDENTIFY macro 
instruction. 

0011 .... indicates that the 

program represented 
by this LPRB was not 
loaded by a LOAD 
macro instruction but 
did have minor 
entries identified by 
an IDENTIFY macro 
instruction. 
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1110 .... indicates that this 
LPRB describes a 
minor entry 
identified by an 
IDENTIFY macro 
instruction. 

.... xx. • Bits 4 and 5 have no 
meaning in LPRB 
displays. 

... . ..1. indicates that the 

program represented 
by this LPRB was 
hierarchy block 
loaded and that a 
program extent list 
existed. 

. ... ...1 indicates that the 

program module 
represented by this 
LPRB was refreshable. 



IRB 



SVRB 



Supervisor request blocks display 
the following bit settings in 
this subfield: 

1100 .... indicates that the 

program represented 
by this SVRB is a 
type 2 SVC routine 
that had not been 
loaded at the time 
the dump was taken. 

1101 .... indicates that the 

program represented 
by this SVRB is a 
type 3 or SVC routine 
that had been loaded. 

, ... 1. . . indicates that the 
type 3 or 4 SVC 
routine was resident. 

.... .1.. indicates that while 
the dumped system was 
active, a checkpoint 
could have been taken 
in a user exit from 
the SVC routine 
represented by this 
SVRB. 

,. ... ..xx bits 6 and 7 have no 

meaning in SVRB 
displays. 



SIRB 



The flag bit setting applicable 
to supervisor interrupt request 
block displays is as follows: 



1000 



xxxx 



indicates that the RB 
being displayed is a 
supervisor interrupt 
request block (SIRB). 
bits 4 through 7 have 
no meaning in SIRB 
displays. 



Interrupt request block displays 
use these flag bits in the 
following manner. 

0100 .... indicates that the RB 
being displayed is an 
interrupt request 
block (IRB). 

.... xxxx bits 4 through 7 have 
no meaning in IRB 
displays . 



byte 3 

The last byte of the SZ/STAB field 
displays more status and attribute 
flags. The possible settings for this 
subfield and their meanings are: 









.1 .. 



. . . . xx. 



.... 00- 



Bit set indicates that 
the WT-LNK field in this 
RB display contains, in 
its last three bytes, 
the address of the TCB 
to which this request 
block is linked. 
Bit 1 set indicates that 
at the time the dumped 
system was active, the 
program associated with 
the RB being displayed 
was active. 

Bit 2 set indicates that 
had the dumped system 
been allowed to continue 
processing without 
intervention by the dump 
program, general 
registers 2 through 14 
would have been restored 
from this RB*s general 
register save area, 
displayed on the 
following two lines. 
The setting of this bit 
is valid only for IRB, 
SIRB and SVRB displays. 
Bit 3 set indicates that 
the program module 
represented by this 
request block was 
reenterable or reusable. 
Bits 4 and 5 are used 
only in IRB or LPRB 
displays. The settings 
of these bits and their 
meanings are: 
This setting indicates 
that the IRB being 
displayed had no 
interrupt queue elements 
(IQEs) associated with 
it. 
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01. . This setting indicates 
that the IRB being 
displayed had associated 
with it interrupt queue 
elements that were 
request queue elements 
(RQEs). 

10. . This setting indicates 
that the request block 
being displayed is a 
dummy LPRB, in a 
partition that 
represents a program in 
the reenterable load 
module area. The LPRB 
for the program is in 
the reenterable load 
module area. 

11., This setting indicates 
that the IRB being 
displayed had interrupt 
queue elements 
associated with it that 
were not request queue 
elements (RQEs). 

. . 1. Bit 6 set indicates that 
when the dumped system 
was active, request 
block storage was to 
have been freed when the 
program returned. 

.... »x Bit 3 indicates wait 

request conditions. The 
meanings of the two 
possible settings for 
this bit are: 

. ... Bit 7 not set indicates 
that the request had to 
wait for a single event 
or for all of a number 
of events. 

...1 Bit 7 set indicates that 
the request had to wait 
for a number of events. 
This number of events 
was less than the total 
number of events that 
were waiting. 



USE/EP hhhhhhhh 

The USE/EP field, as indicated by the 
field identifier, displays two data 
elements. These are shown in the 
following format: 



byte 1-3 

The second portion of the USE/EP field 
displays the address of the entry 
point of the module represented by 
this request block. 

PSW hhhhhhhh hhhhhhhh 

The two words of the PSW field display 
to the user the dumped system's old 
program status word. If the dumped 
system had been allowed to continue 
processing without interruption by the 
dump program, operation would have 
resumed on this PSW. 

Q hhhhhhhh 

The information displayed in this 
field depends upon type of RB being 
displayed. The contents of this 
display field are described below, by 
RB type: 

• PRBs and LPRBs use this field to 
display the address of an LPRB 
describing an entry that was 
identified via the IDENTIFY macro 
instruction. 

• SVRBs representing type 3 or 4 SVCs 
use this field to indicate the size 
of the program they represent in 
bytes . 

• SIRBs and IRBs display in this field 
the address of a 12- or 16-byte 
request element. 

WT-LNK hhhhhhhh 

This field displays information 
pertaining to wait counts and request 
block linkages. The field is divided 
into the following two subf ields : 

byte 

The number of requests that were 
pending at the time the dump was taken 
(wait count). 

byte 1-3 

The address of the next request block 
on the RB queue. If the RB being 
displayed was the last request block 
on the queue, this field shows the 
address of the task control block 
(TCB) that enqueued this RB. 



byte 

The first byte of this field contains 
the use count that was applied to the 
program module represented by the 
request block being displayed. This 
use count was calculated by 
subtracting the number of invocations 
of the DELETE macro instruction from 
the number of times the LOAD macro 
instruction was used. 



RG 0-7 and RG 8-15 

The sixteen-word register save area 
appears only after IRB, SIRB or SVRB 
displays. These two lines display the 
contents of general registers 
through 15 as they were stored in the 
request block. 

MFT PROBLEM PROGRAM BOUNDARIES INFORMATION : 
Each task operating under the MFT option of 
the operating system was assigned a main 
storage partition in which to operate. If 
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the system configuration included 2361 
Large Core Storage, partitions may have 
included area from both hierarchy (main 
storage) and hierarchy 1 (low speed main 
storage). If 2361 Large Core Storage was 
not available or was not used,, hierarchy 1 
pointers were set to zero. Each MFT task 
displays in its dump listing the limits of 
the partition in which it operated. This 
display is presented under the heading "P/P 
BOUNDARIES" (problem program boundaries) in 
the following format: 

HIER hhhhhhhh 

The starting address of the problem 
program's hierarchy partition • 

TO hhhhhhhh 

The ending address of the problem 
program's hierarchy main storage 
partition. 

HIER 1 hhhhhhhh 

The starting address of the problem 
program's hierarchy 1 partition. If 
this field contains zeros* the 
indication is that 2361 Large Core 
Storage was either not available or 
not utilized by this task. 

TO hhhhhhhh 

This last field indicates the high 
limit of the problem program's 
hierarchy 1 partition if one was used. 
If this field contains zeros, either 
2361 Large Core Storage was not 
available or it was not used by this 
task. 

MFT LOAD LIST FORMATTING : A load list was 
maintained by the dumped system's 
supervisor in order to keep track of the 
load modules that were in main storage and 
the area of main storage each occupied. A 
load list created by an MFT supervisor is 
composed of loaded request blocks (LRBs) 
and loaded program request blocks (LPRBs) . 
A formatted listing of the dumped MFT 
system's load list appears as follows: 

LRB 

LPRB hhhhhhhh 

The type of request block being 
displayed and its starting address. 

NM cccccccc 

The eight-character name of the 
program module represented by the 
request block being displayed. 

SZ hhhhhh 

The number of contiguous double words 
that were occupied by the request 
block, the associated program (if 
applicable) and associated supervisor 
work areas. If a program extent list 
was present, the program size is not 
included. 



USE/EP hhhhhhhh 

Use count and entry point address as 
follows: 

byte 

The use count that was applied to the 
program module represented by the 
request block being displayed. This 
use count was calculated by 
subtracting the number of times the 
DELETE macro instruction was issued 
from the number of times the LOAD 
macro instruction was used. 

byte 1-3 

The address of the entry point of the 
program module named in the NM field 
of this RB display line. 

MFT JOB PACK QUEUE FORMATTING : A job pack 
area queue was maintained by the dumped 
system's supervisor for each job step that 
used a program not in the resident 
reenterable load module area. A job pack 
queue created by ah MFT supervisor consists 
of loaded request blocks (LRBs), loaded 
program request blocks (LPRBs) and FINCH 
request blocks (FRBs) . A formatted job 
pack area queue display appears as follows : 

LRB 

LPRB hhhhhh 

FRB 

The type of request block being 
displayed and its starting address. 

NM cccccccc 

The eight -character name of the module 
represented by the request block being 
displayed. 

SZ hhhhhh 

The number of contiguous doublewords 
that were occupied by the request 
block, the associated program (if 
applicable) and associated supervisor 
work areas. If a program extent list 
was present, the program size is not 
included. 

USE/EP hhhhhhhh 

XRWTL 

The usage of this display field is 
dependent upon the type of request 
block being displayed: 

USE/EP 

is used for LRBs and LPRBs and 
displays the use count and entry 
point address as follows : 

byte 

The use count that was applied to 
the program module represented by 
the request block being 
displayed. This use count was 
calculated by subtracting the 
number of times the DELETE macro 
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instruction was issued from the 
number of times the LOAD macro 
instruction was used. 



bytes 1-3 

The address of the entry point of 
the program module named in the 
NM field of this display line. 

XRWTL 

is used for FRBs and shows the 
starting address of the wait list 
element. 

XRREQ hhhhhhhh 

This field appears only in FRB 
displays, and shows the address of the 
TCB representing the task on whose 
behalf this FRB was constructed. 

XRTLPRB hhhhhhhh 

This field appears only in FRB 
displays and shows the starting 
address of the area of main storage 
that was acquired by the FETCH routine 
for the module identified by the NM 
field of this line. 



MFT DATA EXTENT BLOCK (DEB) FORMATTING : 
Data extent blocks (DEBs), describing a 
data set's external storage requirements, 
were queued to those task control blocks 
(TCBs) that represented tasks requiring 
auxiliary storage input/output processing. 
External storage information, taken from 
each DEB, is formatted as shown below: 

DEB hhhhhh 

The starting address of the basic 
section of the DEB being displayed. 

APPENDAGES 

The word "appendages" informs the user 
that the five named fields on this 
line contain information taken from 
the appendage vector table preceding 
the DEB being displayed. The named 
fields appearing on the rest of this 
line are: 



AB END hhhhhh 

The entry point of the abnormal- end 
appendage routine. 

PFX hhhhhhhh hhhhhhhh hhhhhhhh 

The second line of a DEB display 
contains information taken from the 
prefix section of the DEB being 
displayed. The area is subdivided as 
follows : 

byte 

The first byte of the prefix area 
contains the contents of the I/O 
support work area. This area is used 
only by DEBs dealing with direct 
access storage devices. 

bytes 1-7 

The next seven bytes of the DEB prefix 
section are used by DEBs associated 
with direct access storage device 
functions. This subfield displays the 
data set control block's (DSCB) 
address used by I/O support. The 
address is expressed in the following 
format: 



bytes 1 and 2 
bytes 3 and 4 
bytes 5 and 6 
byte 7 



the bin (cell) number, 
the cylinder address, 
the track address, 
the record number. 



bytes 8-11 

The third word of the PFX field 
contains the data control block (DCB) 
modification mask that was used by I/O 
support. 

byte 12 

The length of the DEB in double words. 

bytes 13-15 

The remainder of the DEB prefix 
section is reserved for future use. 

TCB hhhhhhhh 

This field marks the beginning of the 
basic section of the data extent 
block. The TCB field is divided into 
two subfields as follows: 



END OF EXT hhhhhh 

The entry point of the end- of -extent 
appendage routine. 

SIO hhhhhh 

The entry point of the start I/O 
appendage routine,. 

PCI hhhhhh 

The entry point of the 
program-controlled-interruption 
appendage routine. 

CH END hhhhhh 

The entry point of the channel- end 
appendage routine. 



byte 

The number of subroutines for which a 
LOAD macro instruction was issued 
during the execution of the OPEN 
executor routines. 

bytes 1-3 

The starting address of the task 
control block to which this DEB was 
enqueued . 

NDEB hhhhhhhh 

byte 

The overall length of a data extent 
block includes the length of a 
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variable length access method 
dependent section. The first byte of 
the NDEB field expresses the length of 
the access method dependent section in 
bytes. If the access method was BDAM, 
this indicator is expressed as a 
number of full words. 

bytes 1-3 

The last portion of the NDEB field 
displays the starting address of the 
basic section of the next DEB on the 
task's queue. If this DEB was the 
last on the queue, the content of this 
field is the starting address of the 
TCB that enqueued this DEB. 

ASYN hhhhhhhh 

This field contains data set status 
flags and the address of the 
associated IRB: 

byte 

The first byte of the ASYN field 
contains data set status flags. These 
flags have the following meanings: 

xx. . .... Bits and 1 indicate 

the data set's 
disposition. The 
possible settings are: 

01.. ....... This setting indicates 

that the disposition was 
OLD. 

10. This setting indicates 

that the disposition of 
the data set was MOD 
(modify) . 

11.. .... This setting indicates 

that the disposition was 
NEW. 

..1. .... Bit 2 set indicates that 
an end-of-volume (EOV) 
or end-of-file (EOF) 
condition had been 
encountered. 

.. ... 1 ...... The setting of bit 3 has 

one of two meanings 
depending upon the 
external storage medium. 
For disk, this indicator 
reflects a release of 
unused external storage. 
For tape, this indicator 
means that an emulator 
tape with second 
generation format was 
being used. 

.... 1... Bit 4 set is a data 
control block (DCB) 
modification indicator. 

.... . 1. . Bit 5 set has two 

meanings, depending upon 
the auxiliary storage 
recording medium. For 
disk, the setting of bit 
5 indicates that a split 
cylinder was 



..1. 



encountered. For tape, 
this flag indicates that 
an emulator tape with 
possible mixed parity 
records was used. 
Bit 6 set indicates the 
use of nonstandard 
labels. 

Bit 7 set indicates that 
reduced error recovery 
procedures were used on 
magnetic tapes 
containing the data set 
represented by this DEB. 



bytes 1-3 

The last portion of the ASYN field 
shows the starting address of the IRB 
that was associated with asynchronous 
appendage exit scheduling. 

SPRG hhhhhhhh 

This field contains information on I/O 
processing methods and the system 
PURGE routine. 

byte 

The first byte of this field contains 
flags that indicate the method of 
input/output processing and the 
disposition of the data set that was 
to have been performed when an end-of- 
volume condition occurred. These flag 
settings are: 



. . . 
..xx 



. . 01 
..11 



xxxx 



0000 
1111 
0011 
0111 
0001 
0100 



Bit was set by ABEND.. 

The setting of this bit 

indicates that the data 

set associated with this 

DEB was a SYSABEND or 

SYSUDUMP data set. 

Bit 1 is always zero. 

Bit 2 and 3 show the 

end-of-volume 

disposition procedure. 

The values for this flag 

are: 

REREAD 

LEAVE 

The last half of this 

byte contains flags that 

indicate the type of 

i nput/ output process ing 

that was performed on 

the data set represented 

by this DEB. The values 

for this flag are: 

INPUT 

OUTPUT 

INOUT 

OUTIN 

RDBACK 

UPDAT 



byte 1 

The quiesce count. The byte is 
associated with the system PURGE 
routines (SVC 16) , and indicates the 
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number of auxiliary storage devices 
that were executing the user's channel 
programs . 

bytes 2-3 

Reserved for future use. 

UPRG hhhhhhhh 

The UPRG field contains extent 
information and data used by the 
user's purge routines,. This field is 
divided into the following two 
subf ields : 

byte 

The number of extents that were 
specified in the DSCBs associated with 
this DEB. 

bytes 1-3 

The address of the first input/output 
block (IOB) in the user's purge chain. 

PLST hhhhhhhh 

Task priority and supervisor purge 
information are contained in this 
field. This field is formatted as 
follows : 

byte 

The priority of the task under which 
this DEB was enqueued. 

bytes 1-3 

The starting address of a parameter 
list that was used to locate the purge 
event control block (ECB) for a 
supervisor purge request. 

DCB hhhhhhhh 

The DCB field contains three data 
elements. These are displayed in the 
format given below: 



byte 
xxxx 



.... The storage protection 
key that was associated 
with the task under 
which this DEB was 
enqueued. 

1111 A hexadecimal "F" in 

bits 4 through 7 of this 
field identify this 
control block as a data 
extent block (DEB) . 



bytes 1-3 

The starting address of the data 
control block (DCB) that was 
associated with this DEB. 

AVT hhhhhhhh 

The AVT field displays two DEB data 
elements and is subf i elded as follows: 

byte 

The DEB extent scale that is used to 
determine the size of the device 



dependent section of this DEB. For 
direct access devices, a 4 is 
displayed in this subfield. For a 
nondirect access device or a 
communication device, a 2 is 
displayed. 



bytes 1-3 

In most cases, the last portion of the 
AVT field shows the starting address 
of the appendage vector table 
preceding this DEB. This table of 
appendage routine addresses appears on 
the first line of this DEB's display. 



OP-UCB hhhhhhhh 

The contents of this field have 
meaning only when the DEB being 
displayed describes a data set that 
was assigned to a unit record or 
magnetic tape device. This 
information is formatted from the 
device dependent section of the DEB. 
The OP-UCB field is subf i elded as 
follows: 



byte 

This first subfield is applicable only 
to data sets assigned to magnetic tape 
devices, and shows the SET MODE 
operation code. For a data set that 
was assigned to a unit record device, 
this subfield is reserved. 



bytes 1-3 

The starting address of the unit 
control block (UCB) associated with 
the data set described by the DEB 
being displayed. 

The following four fields are present only 
for data sets assigned to the IBM 3525 Card 
Punch for multi -function. The information 
is formatted as shown below: 

UCB hhhhhhhh 
byte 

The device modifier field (not used 
for the 3525). 
bytes 1-3 

The starting address of the unit 
control block (UCB) associated with 
the data set described by the DEB 
being displayed. 

RDRDCB hhhhhhhh 

The starting address of the data 
control block (DCB) for the read 
associated data set. 

PCHDCB hhhhhhhh 

The starting address of the data 
control block (DCB) for the punch 
associated data set. 
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WTRDCB hhhhhhhh 

The starting address of the data 
control block (DCB) for the print 
associated data set. 

The final portion of a DEB display shows 
information pertaining to a data set that 
was assigned to a direct access device. 
This information, taken from the DEB's 
device dependent section, is arranged in 
columnar format with a line for each 
extent. The information is formatted as 
shown below: 

FM-UCB hhhhhhhh 

The first column displays two data 
elements and is formatted as follows: 

byte 

The device modifier showing the file 
mask. 

bytes 1-3 

The starting address of the unit 
control block (UCB) that was 
associated with the data extent. 

START hhhhhhhh 

The address of the beginning of the 
direct access device extent. The 
first four characters represent the 
cylinder address and the last four 
characters represent the track 
address. 

END hhhhhhhh 

The address of the end of the data 
extent. Cylinder and track references 
are formatted as in the extent 
beginning address, described above. 

TRKS hhhh 

The number of direct access tracks 
bounded by the starting and ending 
addresses shown in the previous two 
columns. 



MFT TASK INPUT/OUTPUT TABLE (TIOT) 
FORMATTING : A task input/output table 
(TIOT) was constructed for each task in the 
dumped system by MFT job management 
routines. This table contained primary 
pointers to control blocks used by I/O 
support routines. As the functions of 
several TIOT fields were dependent upon the 
state of associated external storage 
devices, multiple definitions may apply. 
The TIOT that was constructed in the dumped 
MFT system is formatted as shown. 

TIOT hhhhhh 

The starting address of the task 
input/output table being displayed. 

JOB cccccccc 

The eight -character name of the job 
for which this TIOT was constructed. 



STEP cccccccc 

The eight-character name specified in 
the label field of the EXEC JCL 
statement associated with this job 
step. 

PROC cccccccc 

If the job step for which this TIOT 
was constructed was invoked from a 
cataloged procedure, the procedure 
name, as contained in the EXEC JCL 
statement, is displayed in this field. 

Each data set associated with the indicated 
task is represented by a separate DD entry 
that is included in the TIOT. Each TIOT 
entry is displayed on a separate line in 
columnar format. The use and meaning of 
each column is given below: 

OFFSET hhhh 

The offset of this DD entry from the 
beginning of the TIOT in hexadecimal. 

LN-STA hhhhhhhh 

byte 

The total length (including all device 
entries) in bytes of the DD entry 
being displayed on this line. 

byte 1 

Status byte A, one of three status 
bytes in a TIOT entry. The meanings 
of the status byte settings are: 

x. ... .x.. Bits and 5 indicate 
the tape label 
processing that was to 
have been performed. 
The meanings of the 
settings are: 

0... .0.. Nonlabeled tape or an 
indication to bypass 
label processing. 

0... .1.. Standard labels or 

standard user labels. 

1 . . . . . . Nonstandard labels . 

.1.. .... The setting of status 

bit 1 has two meanings, 
depending upon the 
processing phase that 
had been reached at the 
time the system was 
dumped. During 
allocation processing, 
the setting of this bit 
indicates that this 
entry represents a split 
cylinder primary space 
allocation DD. If the 
dump was taken during 
step termination 
processing, the setting 
of this bit indicates 
that no unallocation of 
space was necessary. 
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. .1. ...... The setting of status 

bit 2 works under the 
same philosophy as 
status bit 1. During 
allocation processing, 
the setting of this bit 
indicates that this 
entry represents a split 
cylinder secondary space 
allocation DD. If the 
dump was taken during 
step termination 
processing, the 
indication was one of 
rewinding with no 
unload. 
...1 .... Bit 3 set indicates that 

this DD entry represents 
a JOBLIB. 
.... 1... Bit 4 set indicates that 

direct access device 
space management was 
deemed necessary. 
.... ..1. The setting of bit 6 

specifies that the tape 
volume was to have been 
rewound and unloaded. 
..... ...1 The setting of bit 7 

specifies that the tape 
volume was to have been 
rewound, 
byte 2 

The third byte of this column has 
meaning only during the allocation 
phase. This displays the number of 
devices that were requested by the 
data set represented by the TIOT entry 
displayed on this line. 

byte 3 

The last byte of the LN-STA field 
displays a TIOT field that had meaning 
at two points during the processing of 
this task. During the allocation 
process, this field contained a link 
to the appropriate prime split, unit 
affinity,, volume affinity or 
suballocate TIOT entry. After CLOSE 
processing, this byte was used as 
follows : 

1... .... The setting of bit 

indicates that the data 
set represented by this 
DD entry was a SYSOUT 
data set that contained 
data. 
.xxx xxxx Bits 1 through 7 are 

reserved for future use. 

DDNAME cccccccc 

The eight character DD name associated 
with the TIOT entry being displayed. 

TTR-STC hhhhhhhh 

The first three bytes of this column 
display the relative track address 
(TTR) of the job file control block 
(JFCB) associated with this entry. 



STB-UCB hhhhhhhh 

The last column in a TIOT display 
contains information taken from the 
one -word device entries that are 
appended to each TIOT entry. One TIOT 
device entry exists for each allocated 
device. This display field shows this 
information in the following format: 

byte 

Status byte B. The status bits have 
the following meanings: 

1... .... Bit set indicates that 

the data set associated 
with this line of the 
TIOT display was present 
on the device 
represented by this TIOT 
device entry. 

.1.. ..... Bit 1 set indicates that 

the data set associated 
with this line of the 
TIOT display would have 
used the device 
represented by this TIOT 
device entry. 

..1. .... Bit 2 set indicates that 
the device represented 
by this device entry 
violated separation. 

...1 .... Bit 3 set indicates that 
a volume serial number 
was pres ent . 

.... 1... Bit 4 set indicates that 
a setup message was 
required. 

.... .x.. Bit 5 indicates the 

device disposition that 
would have taken place 
had the dumped system 
been allowed to continue 
processing this task. 
The settings for this 
bit are: 

.... .0.. Indicates that if the 
volume was required to 
be unloaded, the volume 
was to have been 
deleted. 

.... .1.. Indicates that if the 
volume was required to 
be unloaded, the 
unloaded volume was to 
have been retained. 

.... . .1. Bit 6 indicates that an 

unload requirement had 
been made. 

.... ...1 Bit 7 set indicates that 

a load or label 
verification requirement 
had been made, 
bytes 1-3 

The address of the UCB that was used 
in all cases except when the device 
was a 2321 data cell drive. For a 
2321, this address is that of the 
description in the UCB of the cell in 
the bin. 
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TSO System Block Formatting 

The TSO control blocks are divided into two 
groups: system and user. The control 
blocks are discussed in the order in which 
they appear when both groups are requested. 
Some control blocks are formatted and 
printed when either group is requested. 



An example of a TSO system and user dump 
listing is shown in Figure 24. 



TIME SHARING COMMUNICATIONS VECTOR TABLE 
(TSCVT) FORMATTING : The time sharing 
communications vector table is a secondary 
CVT to meet the time sharing requirements. 
The time sharing CVT resides in the time 
sharing region; therefore, it exists only 
while the time sharing region is active. 
When time sharing does not exist in the 
system, the MVT CVT pointer to the TSCVT is 
zero. 



TSCVT hhhhhh 

The address of this time sharing 
communications vector table. 

TJB hhhhhhhh 

The address of the time- sharing job 
block (TJB) table. This table 
contains all of the TJBs allowed TSO 
users. The first TJB is for the 
terminal job identification (TJID) 
equal to zero. 

RCB hhhhhhhh 

The address of the region control 
block (RCB) table. It is an indexed 
table containing one RCB for each 
possible time sharing region; 
therefore, the table contains the 
maximum number of RCBs that may be 
used by time sharing. The first RCB 
is for region one. 

RPT hhhhhhhh 

The address of the reference point 
table (RPT). It is used by the 
terminal input output coordinator 
(TIOC). 

FLG hhhh 

These flags indicate functions 
requested from the time sharing 
control task (TSC). 



.1.. .... TSCSWPBG: Bit 1 set 

indicates that a swap should 
be started. 

..1. .... TSCLOGON: Bit 2 set 

indicates that a logon is 
required. 

...1 .... TSCDISC: Bit 3 set 

indicates that a disconnect 
is required. 

.... xxxx Bits 4 through 7 are 

reserved for future use. 

byte 1 

Reserved for future use. 

FL1 hhhh 

These flags indicate atypical 
functions required by the time sharing 
control task (TSC) . 



byte 
1... 



.1. . 



.1. . 



byte 
1 . . . 



TSCSWPND: Bit set 
indicates that a swap has 
ended. 



TSCSSTOP: Bit indicates 
that a system stop has been 
requested and the time 
sharing system is in the 
process of stopping. 

TSCRSTOP: Bit 1 indicates 
that a region stop has been 
requested. 

TSCASTOP: Bit 2 is the 
ABEND-STOP flag. When set, 
it indicates to the time 
sharing control task (TSC) 
that time sharing should be 
stopped. This flag is set 
by (1) the TSO/RMS interface 
return when a machine check 
occurs in TCAM or (2) the 
TCAM STAE exit when TCAM 
abnormally terminates. 



...x xxxx Bits 3 through 7 are 

reserved for future use. 

byte 1 

Reserved for future use. 

SDC hhhhhhhh 

The address of the first data control 
block (DCB) for swap data sets. 

CUS hhhh 

A count of the current TSO users 
logged onto the system. For 
additional users to be logged onto the 
system, this number must be less than 
the value in LUS. 
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3 
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8 
8 

O 
H 



5 



MODULE IMOSADMP DATE 11/12/70 TIME 00.12 



PAGE OOOf 



TSCVT 0DDA9O 


TJB 


0G0CDCE8 




CUS 


OC04 




SAV 


000DDB20 




102 


000D3B50 




SLF 


000CDF10 




SVQ 


ccccoooo 




OMP 


0C0DD998 


RCB 0DDFB8 


RCT 


0001A7B8 




NMBR 


01 




UTTMQ 


0000 




PRG 


OEOOOOOO 




CONID 


00 


UWSM 0DDFA8 


ADDR- 


-LN 0A58C 



RCB 000DDFB8 
LUS OOOA 
ECB 000DDB14 
103 00OD3E46 
TSC 0001ACD0 
ABN 000D1C20 
T06 0001A5D8 



ECB C0000001 
PKEY EO 
CUSE 0004 
PRG1 000A79D0 
RESV 000000 



RPT 000D9DD0 
NTJ OOOA 
SIA OOODDCDC 
002 000D28C8 
SPL 0001B4E8 
D03 000DE880 



FLG 0000 
SZU 0030 
ICB 000DDC34 

LCQ odoooooo 

RSZ 0028 
FLM 000DFD40 



FL1 
CTR 



0000 
0001 
101 000D38C4 
TRB 00000000 
RSV 0000 
QTP 00ODFD40 



SDC 00000000 
MUS OOOA 
TQE 00014674 
LPA 00000000 
SVT 00000000 
T08 000DEAD8 



DIECB 00000000 
UMSMN 04 
EXTNT 000A7F68 
PRG2 000A7F1C 



TJID 0004 
FLG 40 
UMSM 000DDFA8 
QPL 000A7F10 



RSIZE 004B 
FLG2 20 
SDCB 000DE120 
STECB 00000000 



LSQSZ 0005 
FBQE 01 
PQE 0001AC20 
RCOVR OBOOFFOO 



ADDR-LN 0CB80020 



ADDR-LN 00000000 



ADDR-LN OOOOOOCO 



SWAP DCB 000000 



GA5800 
0A580O 
0A5820 
0A584C 
OA5860 
0A5880 
0A6C20 
0A6C40 
0A6C60 
0A6C8C 
0A6CA0 
0A6CC0 
0A6CE0 



STORAG 
00000000 
00000000 

ocoooooo 
cooooooo 

TO NEXT 
0012CC02 
000CCFA3 
000A7788 
00000000 
00000000 
00040C00 
COOOOOOO 



E KEY 
000A58C8 00CA7260 00000000 
OOCAFOOO OCOOOOOO 00000000 
000C1468 OCCCOOOC OCOOOOOO 
COOOOOOO CCCCOOOO 00000000 

LINE ADDRESS SAME AS ABOVE 
CCCOOOOO FFC40000 0000CAF8 
0000C28C C0OA6D68 000A7700 
00C1C1C0 000D9DF4 OCOOOOOO 
OOCCOOOO CCCOOOOC OCOOOOOO 
00000000 OO0A7478 00000098 

ccccccco cccqoooo oooooooo 

COOCCCOO CCCCOOOO 00030000 



000A5800 00002800 0OCA582O 000A5820 * 

0001A7B8 00028000 000A5800 OOOOOOOO * 

OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO * 

OOOOOOOO OOOOOOOO OCOOOOOO OOOOOOOO * 

OOOOOOOO 000A7700 COOOOOOO OOOOOOOO * 8 

4000A4B6 00000001 000DDD18 000D9DD0 * B 

A000A5F3 9000A60C OOOOOOOO OOOOOOOO * A. ...4 8. 

OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOCO * 

000CD710 OOOOOOOO 00124034 0OOOB834 * P.. 

OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO * 

OOOOOOCO OOOOOOOO .COOOOOOO OOOOOOOO *. 
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MODULE IMDSADMP DATE 


11/12/70 TIME 00.12 PAGE 0007 




***** TS USER CONTROL BLOCKS 


***** 




****************** USER KGN01 TJID=0001 ******************** 




TJB 0DDD18 


TSB 000D9DF4 ATTN 00 STAX 01 STAT 


00 STAT2 


00 EXTNT 000A7F68 




RCB 000DDFB8 UMSM 000DDFO8 SDCB 000DE120 UTTMQ 0002 RSTOR 


48 UMSMN 04 




USER KGN01 IPPB 00000000 NEWID 00 FLUSL 


00 TJID 


0001 MONI 00 




RSV OCOOOO 






UMSM 0DDF08 


ADDR-LN 0A5 80C38 ADDR-LN OA980058 ADDR-LN 0CB00028 


ADDR-LN 


00000000 


TSB 0D9DF4 


STAT 81 TJB 0DCD18 FLG1 00 WTSB 000000 LNSZ 


78 OTBFP 000000 




NOBF 00 CBFP 000000 BPKFL 00 ITBFP OOOOOC 


NITR 


01 IBFP ODAOFO 




CLEAR 00 QCB 0E1CCO ECB 00000000 TJID 0001 


STCC 


0000 ATNLC 0016 




ATNTC 0000 LNNO 00 BLNK 00 ASRCE 0000 ATNCC 


0003 AUTOS 00000000 




AUTOI 00000000 ERSDS 00000000 






**** THE FOLLOWING TJBX,TAXE,PSCB tTCB' S AND STORAGE ARE FROM THE SWAPPED 


DATA SET 


***** 


TJBX 0A7F68 


XFST 000A7DAC XLAST 000A6D68 XDSE 0OOA7320 XSVRB 


O00A77OO 


XRQE 00000000 XlQE 00000000 




TAXE 000A6CB0 XLECB 00000000 XPSWD RSV 


00000000 


XAIQE 00000000 XQPL 000A7F10 




XNQPE OOOA XNTCB 0002 XLQPL 0054 HBFL 


0000 


XACT 00000000 XAECB 0001A534 




XKEYA C0CA7FB0 






JOB KGN01 


STEP KGN01 PROCSTEP STARTING 






TCB 0A7DA0 


RBP 000A7018 PIE 00000000 DEB 00000000 TIO O0OA7864 


CMP 00000000 TRN 00000000 




MSS 030A79A0 PK-FLG EOOOOOOO FLG 0001B8B8 LLS O0OA7EA0 


JLB 00000000 JPQ 000A7EB0 




RG 0-7 00000001 FFF58C74 0001A534 0001A500 000A7510 


000A7DA0 


00000000 00000001 




RG 8-15 000A7370 FFFFFFF9 000A7564 000A6D68 600FEAB2 


O0OA7534 


400FES30 600062FA 




FSA 030000C0 TCB 000A6D68 TME 00000000 JST O0OA7DA0 


NTC 00000000 OTC 0001A7B8 




LTC 000A6D68 IQE 00000000 ECB OOODDFBC TSPR 8000B82B 


D-PQE 000A5810 SQS 000A6D40 




STA 200CC498 TCT 00CA73D8 USR 00000000 OAR 00001000 


RES 00000000 JSCB OOOA7E0O 


ACTIVE RBS 








PRB 0A7D18 


RESV 00000000 APSW 00000000 WC-SZ-STAB 00040083 FL-CDE 0001D5BC 


PSW FF050001 500FEC8A 




Q/TTR OOOCOOOO WT-LNK 010A7DA0 NM IEFSD263 EPA OFEABO 


STA OFEABO 


LN 000550 ATR1 B9 


MAIN STORAGE 








D-PQE 000A5810 FIRST 000A5820 LAST 000A5820 






PQE 0A5820 


FFB OCCCCOOO LFB OOOAFOOO NPQ OOOOOOCO PPQ 00000000 
TCB 0001A7B8 RSI 00028000 RAD 000A5800 FLG 0000 
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MODULE IMDSADMP DATE 11/12/70 TIME 00.12 PAGE 0010 


DEB 


OA74A4 


APPENDAGES END 


OF EXT 01516E SIO 01516C PCI 


0151DC CH END 0151A0 AB END 01516C 








PFX OOOOOOOO C2CO0C0B 00003FE2 11000000 










TCB 050A6D68 NDEB 


01000000 


ASYN 69000000 SPRG 


OOOOOOOO UPRG 02000000 PLST B8000000 


DCB EF0CCE64 






AVT 04015158 
















FM-UCB START 


END 


TRKS 












50002AFO 0C61C000 


0C920013 


03E8 












50002AB0 009FOOOO 


00C60013 


0320 








TIOT 


0A6E28 


JOB KGN01 STEP 


TMP 


PROC KGNP01 










OFFSET 


LN-STA 


DDNAME 


TTR-STC 


STB-UCB 










0018 


140401 CO 


SYSPRINT 


00491600 


80002570 










002C 


14040140 


SYSCCMD 


00480A00 


80002AF0 










0040 


14040100 




C0481000 


80O02AB0 










0054 


14040100 


SYSUCUMP 


00491800 


80002530 










0068 


14040100 


SYSUT1 


00481200 


80002530 










007C 


14040100 


SYSUT2 


004B0600 


80002570 










0090 


14040100 


BSLOUT 


00491A00 


800025F0 










00A4 


14040100 


SNAPTAPE 


004C1100 


80002530 










C0B8 


14000010 


DD1 


C04B0800 


OOOOOOOO 










OOCC 


14000010 


0D2 


004B0C00 


OOOOOOOO 










OOEO 


14000010 


DD3 


004B0E00 


OOOOOOOO 










00F4 


14000010 


DD4 


004E0100 


OOOOOOOO 










0108 


140C0010 


0D5 


004E0300 


OOOOOOOO 










one 


14000010 


DD6 


004E0500 


OOOOOOOO 










0130 


140C0010 


DD7 


004E0900 


OOOOOOOO 










0144 


140C0010 


DD8 


004E0B0O 


OOOOOOOO 






PSCB 


0A7B88 


USER 


KGN01 


USRL 


05 GPNM 


SYSDA 


ATR1 EOOO ATR2 0000 CPU 


00018B00 






SWP 


C04C33FD 


LTIM 008A0560 TCPU 


OOOOOOOO 


TSWP OOOOOOOO TCON OOOOOOOO TC01 OOOOOOOO 






RLGB 


0CCA8700 


UPT 0O0A86FO UPTL 


0010 


RSV1 0000 RSV2 OOOOOOOO USE] 


OOOOOOOO 






USE2 


CCCCCOOO 












TAXE 


0A6CB0 


TMFLD 


00 


PPSAV 0CD710 ABOPSK OOOOOOOO WCSA 00 SIZE 12 


STAB 4034 






EP 


00C0B834 


LOPSW 00040000 ROPSW 00000 


3C2 USE 00 IQE 000000 


WCF 00 






LINK 


000000 


GRO COOOOOOC GR1 


OOOOOOOO GR2 OOOOOOOO GR3 OOOOOOOO 


GR4 OOOOOOOO 






GR5 


OOOOOOOO 


GR6 OOOOOOOO GR7 


OOOOOOOO GR8 OOOOOOOO GR9 OOOOOOOO 


GR10 OOOOOOOO 






GR11 


OOOOOOOO 


GR12 OOOOOOOO GR13 OCOCOOOO GR14 OOOOOOOO GR15 OOOOOOOO 


NIQE OOOOOOOO 






LNK 


000A6D14 


PRM1 OOOOOOOO IRB 


000A6CB0 TCB 000A6CB0 TLNK 000A6D68 


XPSW OOOOOOOO 






EXIT 


OOOOOOOO 


STAT OOOOOOOO PARM 0OOABBF8 TAIE C0OCCF7C IBUF OOOOOOOO 


USER 000CCDB4 



Figure 24. Sample of TSO Control Block Format (Part 3 of 3) 



LUS hhhh 

The maximum number of TSO users that 
may be logged onto the system. For 
additional users to be logged onto the 
system, the value of LUS must be 
greater than the value in CUS. LUS 
cannot exceed the value in NTJ- LUS 
is set by the time sharing control 
task (TSC). This field is initially 
set to the same value as MUS; however, 
if TSO encounters I/O errors while 
swapping users in and out„ the time 
sharing control task reduces this 
value to limit the number of TSO 
users . 



NTJ hhhh 

The number of time- sharing job blocks 
(TJBs) and terminal status blocks 
(TSBs) allocated when TSO was started. 
The dummy TJB for the terminal job 
identification (TJID) equal zero is 
not included. The value of LUS cannot 
exceed this number. 



SZU hhhh 

The number of bytes in the time 
sharing job block (TJB) . 

CTR hhhh 

Contains the number of region control 
blocks (RCBs) allocated when TSO was 
started. This number cannot be 
increased after the TSO system is 
started. 

MUS hhhh 

The maximum number of users that may 
be logged onto a TSO system. This 
field is set by the START and MODIFY 
commands issued by the operator. 

SAV hhhhhhhh 

The beginning address of three 18-word 
save areas used by the time sharing 
control task (TSC) , the time sharing 
interface program (TSIP), and the time 
sharing dispatcher. 

ECB hhhhhhhh 

The address of the table control block 

(TSECBTAB) which contains the event 
control blocks (ECBs) used to post the 
time sharing control task (TSC) , the 
region control tasks (RCTs) , and the 
terminal input output coordinator 

(TIOC) . 

SIA hhhhhhhh 

The address of the time sharing 
interface area (TSIA). 

ICB hhhhhhhh 

The address of the time sharing 
interface control block (TSICB) . 



101 hhhhhhhh 

The address of the branch entry point 
IKJEAI01 in the time sharing interface 
program (TS IP ) . 

TQE hhhhhhhh 

The address of the timer queue element 
(TQE) used by TSO for time slicing. 

102 hhhhhhhh 

The address of the entry point 
IKJEAI02 in the time sharing 
dispatcher. 

103 hhhhhhhh 

The address of the entry point 
IKJEAI03 in the' time sharing 
dispatcher. 

D02 hhhhhhhh 

The address of the entry point to the 
TSO driver routine (IKJEAD02), or the 
equivalent entry in a user written 
routine. 

LCQ hhhhhhhh 

The address of the first element in 
the logon communications queue. 

TRB hhhhhhhh 

The first address in the trace control 
block chain. This address is 
established and used by the statistics 
collection routine. It is set to zero 
by the time sharing control task 
(TSC). 

LPA hhhhhhhh 

The address of the first contents 
directory entry (CDE) in the time 
sharing link pack area. 

SLF hhhhhhhh 

The address of the system-initiated 
logoff routine. 

TSC hhhhhhhh 

The address of the task control block 
(TCB) for the time sharing control 
task (TSC). 

SPL hhhhhhhh 

The address of the start parameter 
list. 

RSZ hhhh 

The minimum number of 2K blocks for a 
region during logon. 

RSV hhhh 

Reserved for future use. 

SVT hhhhhhhh 

The contents of the SVC table entry 
used by the time sharing interface 
program (TSIP) . 
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SVQ hhhhhhhh 

The contents of the SVC table entry 
used by the TCAM/TIOC interface 
program. 

ABN hhhhhhhh 

The address of the out-of-main storage 
abnormal termination routine 
(IKJEAT07). The routine is resident 
in main storage. 

DO 3 hhhhhhhh 

The entry point address to the TSO 
driver MODIFY routine (IKJEAD03), or 
the equivalent entry point address in 
a user written routine. 

FLM hhhhhhhh 

The entry point address IKJEFLM for 
the system initiated logoff routine. 

QTP hhhhhhhh 

The entry point address IKJGGQT1 for 
the branch entry to the TCAM interface 
program (QTIP) . 

TO 8 hhhhhhhh 

The entry point address to the TSO 
command routine (IJEAT08) for TSO 
dumps taken by the time sharing 
control task (TSC) TSO dumps. 

DMP hhhhhhhh 

The address of the TSO dump control 
block,. 

TO 6 hhhhhhhh 

The TCB address of the TSO dump 
routine (IKJEAT06) for the time 
sharing control task (TSC) modify 
routine. 

TIME SHARING REGION CONTROL BLOCK (RCB) 
FORMATTING : A region control block (RCB) 
contains information that is unique to a 
time sharing region. There is one RCB for 
each time sharing region. The RCBs reside 
in the time sharing control tasks region, 
they are contiguous, and they are created 
during initialization of the time sharing 
controller. 

RCB hhhhhh 

The address of the RCB. 

RCT hhhhhhhh 

The address of the task control block 
(TCB) for this region control task 
(RCT) . The TCB contains the address 

of the partition queue element (PQE) 

that defines the region. 

ECB hhhhhhhh 

The event control block (ECB) on which 
this region control block (RCB) waits. 
This ECB must be posted before this 
region control task (RCT) can perform 
one of its functions. 



DIECB hhhhhhhh 

The event control block (ECB) that is 
posted upon completion of this region 
control task (RCT) . The time sharing 
control task (TSC) waits for this ECB 
to be posted. 



TJID hhhh 

The terminal job identification (TJID) 
for the time sharing job currently 
executing in this region. 



RSIZE hhhh 

The number of 2K blocks in this 
region. It is set by the time sharing 
control task (TSC) when the time 
sharing system is started. 

LSQSZ hhhh 

The number of 2K blocks in the local 
system queue space (LSQS) for this 
region. It is set by the time sharing 
control task (TSC) when the time 
sharing system is started. 

NMBR hh 

The identification number assigned to 
this region. 

PKEY hh 

The protect key (PKEY) for the time 
sharing job currently executing in 
this region. 

UMSMN hh 

The number of entries in the main 
storage map which describes the main 
storage image that was initialized 
during logon. 

FLG hh 

This field contains the first byte of 
the region control block (RCB) flags. 
The flags indicate various functions 
to be performed by the region control 
task (RCT) and time sharing control 
task (TSC). These flags are set by 
the time sharing interface program 
(TSIP) , the time sharing control task 
(TSC), and the terminal input/output 
coordinator (TIOC). These flags are 
tested and reset by the region control 
task (RCT) and the time sharing 
control task (TSC) . 



1. 



.1. 



RCBFQO: Bit is the 
quiesce flag. When set, 
this flag indicates that the 
current user of this region 
should be quiesced. 

RCBFSO: Bit 1 is the swap 
out flag. When set, this 
flag indicates that the 
current user should be 
swapped out. 
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,1. .... RCBFSI: Bit 2 is the swap 
in flag. When set, this 
flag indicates that the 
current user of this region 
should be swapped in. The 
user's terminal job 
identification (TJID) is in 
the region control block 
(RCB) . 

, .1 .... RCBFRS: Bit 3 is the 

restore flag. When set, 
this flag indicates that the 
user, whose terminal job 
identification (TJID) is in 
the region control block 
(RCB),, should be restored by 
the region control task 
(RCT). 



The flag is set to one when 
the region control task is 
initialized; it is set to 
zero when the region control 
task is terminated. 

.1 .... RCBSTR1: Bit 3 indicates 

that a region start has been 
requested, and the region 
control task should be 
attached. 

, . 1... RCBSTR2: Bit 4 indicates 

that a region start has been 
requested, and a swap logon 
image should be created. 

, . .xxx Bits 5 through 7 are 

reserved for future use. 



1... RCBOCAB: Bit 4 set 
indicates that the 
out-of-main storage abnormal 
termination routine was 
invoked. 

.x. . Bit 5 is reserved for future 
use. 

-.1. RCBFAT: Bit 6 is the 

attention exit flag. When 
set, this flag indicates 
that an attention exit has 
been requested for one or 
more users. 



1 RCBFND: Bit 7 is the END 
region control task (RCT) 
flag. When set, this flag 
indicates that the region 
control task (RCT) should 
terminate normally and 
return control to the time 
sharing control task (TSC). 



FLG2 hh 

This field contains the second byte of 
the region control block (RCB) flags. 
See FLG. 



1. 



..1. 



RCBFSE: Bit is the swap 
end flag. When set, this 
flag indicates that the 
swap-in operation for the 
current user of this region 
is complete. 

RCBSTOP: Bit 1 is the 
region stop flag. When set, 
this flag indicates that a 
request has been made to 
stop the region. Every user 
of this region will be 
logged off. 

RCBACTV: Bit 2 indicates 
the active status of the 
region control task (RCT). 



FBQE hh 

The number of free block queue 
elements (FBQEs) for this region. 

UTTMQ hhhh 

The relative track address (TT) of the 
map queue pointer. The map queue 
pointer describes the location of the 
region's initialized logon image on 
the swap data set. 

CUSE hhhh 

The number of users logged on to use 
this region. The time sharing control 
task (TSC) increments the count before 
disconnect (DISC) and decrements the 
count during logon. 

EXTNT hhhhhhhh 

The address of the initialized time 
sharing job block extension (TJBX). 
The TJBX is created during the logon 
initialization for this region. 

UMSM hhhhhhhh 

The address of the user main storage 
map. This map describes the 
initialized logon main storage image 
for this region. 

SDCB hhhhhhhh 

The address of the swap data set 
control block (SDCB). This block 
points to the location of the 
initialized logon image on the swap 
data set for this region. 

PQE hhhhhhhh 

The address of the partition queue 
element (PQE) pointer in the system 
queue space (SQS) . The PQE describes 
the main storage space assigned to 
this region. The PQE pointer is used 
to manipulate main storage when (1) 
this region control task's (RCT's) 
region is obtained during start time 
sharing initialization and (2) this 
region control task's (RCT's) region 
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is freed during region control task 
termination. 

PRG hhhhhhhh 

PRG1 hhhhhhhh 

PRG2 hhhhhhhh 

These three words constitute the SVC 
I/O purge parameter list- For further 
information,, see the "Purge Macro 
Instruction" in the publication IBM 
System/360: System Programmer' s 
Guide , GC28-6550. 

QPL hhhhhhhh 

The address of the qui e see I/O 
parameter list- 

STECB hhhhhhhh 

An event control block (ECB) . During 
a subsystem recovery, the time sharing 
control task (TSC) waits for this ECB 
to be posted by the region control 
task (RCT) . The posting is done 
during end processing. 

RCOVR hhhhhhhh 

These bits indicate the current 
recovery status of the region control 
task (RCT) in the event of a subsystem 
failure, 
byte 

1... .... RCBRCOVR: Bit set 

indicates that the status 
bits in the following 3 
bytes are valid. 

. xxx xx. . Reserved for future use. 

.... ..x. RCBWTOR: WTOR restore 

processing complete. 



byte 1 
1 . .. . 



.1. 



1 . 



. .x RCBTACMP: Transient area 

restore processing complete. 
— RCBRSFLG 

. .. RCBRSTRT: Bit set 
indicates a restore. 

. .. RCBTCBDN: Bit 1 set 

indicates that the task 
control blocks (TCBs) have 
been requeued. 

RCBQELCM: Bit 2 set 

indicates that the queue 
element (QEL) restore 
processing is complete. 

RCBTQECM: Bit 3 set 
indicates that the timer 
queue element (TQE) restore 
processing is complete. 

RCBRQIQC: Bit 4 set 
indicates that both the 
request queue element (RQE) 
and the interrupt queue 
element (IQE) restore 
processing is complete. 



.... .1.. RCBIORSC: Bit 5 set 

indicates that' the I/O 
restore processing is 
complete. 

.... ..xx Bits 6 and 7 are reserved 

for future use. 

byte 2 — RCBQUFLG 

1 .. RCBQUSTR: Bit set 

indicates that quiesce has 
started. 

.1.. .... RCBIOSTR: Bit 1 set 

indicates that the first 
entry into the I/O purge 
routine is complete. 

..1. RCBTADON: Bit 2 set 

indicates that the transient 
area quiesce is complete. 

...1 .... RCBWTORD: Bit 3 set 

indicates that the write to 
operator with reply (WTOR) 
quiesce is complete. 

.... 1... RCBQELDN: Bit 4 set 

indicates that the queue 
element (QEL) quiesce is 
complete. 

.... .1,.. RCBIODON: Bit 5 set 

indicates that the second 
entry I/O purge is complete. 

-.1. RCBTQEDN: Bit 6 set 

indicates that the timer 
queue element (TQE) quiesce 
is complete. 

1 RCBRQIQD: Bit 7 set 

indicates that both the 
request queue element (RQE) 
and the interrupt queue 
element (IQE) are complete. 



byte 3 
1... 



RCBSWTCH: Bit indicates 
the method of search used by 
various subroutines in 
IKJEAT07. When equal to 
zero, all system users are 
purged according to the 
terminal job identification 
(TJID). When equal to one, 
all users in this region are 
purged as indicated by the 
region control block 
addresses. 



,1 RCBSWTON: When bit 1 is set 

along with bit being set, 
all system users are purged. 
A search is made according 
to the terminal job 
identification (TJID) and 
the request control block 
(RCB) . 
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..xx xxxx Bits 2 through 7 are 

reserved for future use. 

CONID hh 

The routing code of the console that 
issued the last START, MODIFY, or STOP 
command. 

RESV hhhhhh 

Reserved for future use. 

USER MAIN STORAGE MAP (UMSM) FORMATTING : 
The UMSM is used in the swap operation. 
One user main storage map exists for each 
possible time sharing user. The UMSM 
contains a series of consecutive one-word 
extent fields (ADDR-LN) . Each one-word 
extent contains a halfword address field 
(ADDR) and a halfword length field (LN) 
that describe the main storage space 
allocated to the time sharing user. The 
number of UMSM extents has established 
defaults that can be modified by the 
operator when he starts the time sharing 
system. The number of extent entries is 
stored in the time sharing job block (TJB) 
at TJBUMSMN. Unused extent fields contain 
zeros . 

UMSM hhhhhh 

The address of the user main storage 
map. 

ADDR-LN hhhhhhhh 
bytes and 1 

Begin Address: This field contains 
the two high order bytes of the 
beginning address of the main storage 
segment allocated to the time sharing 
user. Since main storage is allocated 
in 2K blocks, the low order byte is 
always zero and, therefore, need not 
be kept in a control block. 

bytes 2 and 3 

This field contains the two high-order 
bytes designating the length of the 
main storage space allocated to the 
time sharing user. Since main storage 
is allocated in 2K blocks, the 
low-order byte is always zero and, 
therefore, need not be kept in a 
control block. 

SWAP DATA CONTROL BLOCK (SWAP DCB) 
FORMATTING : The swap data control block 
(SWAP DCB) is used whenever a time sharing 
user's region is swapped into or out of 
main storage. Each region control task 
(RCT) has one swap data control block. 
Following the address of the swap data 
control block is the contents of the main 
storage data that was written on the swap 
data set . 

SWAP DCB hhhhhhhh 

The address of the swap data control 
block. 



TIME SHARING JOB BLOCK (TJB) FORMATTING : 
The time sharing job block (TJB) contains 
status information about the time sharing 
user. The TJB is retained in main storage 
while the user is swapped out. One time 
sharing job block exists for each possible 
simultaneous time sharing user. The space 
for the TJB is obtained from the time 
sharing control task (TSC) region during 
time sharing initialization. Status 
information about terminals related to this 
TJB is contained in the terminal status 
block (TSB) . The address of the terminal 
status block is the first word of the TJB. 



TJB hhhhhh 

The address of this TJB. 



TSB hhhhhhhh 

The address of the terminal status 
block (TSB) that owns this terminal 
job. If zero, this job was started by 
an operator command. 



ATTN hh 

A count of the unprocessed attention 
interrupts for this job. 



STAX hh 

The number of scheduled specify 
terminal attention exits (STAXs). 

STAT hh 

This field contains flags that 
indicate the status of the time 
sharing job. 



1.. 



,1. 



.1. 



,1 . 



. 1. 



TJBNJB: Bit set indicates 
that this TJB is currently 
unused. 

TJBINCOR: Bit 1 set 
indicates that this user is 
currently in main storage. 

TJBLOGON: Bit 2 set 
indicates that the logon 
start has been set by the 
terminal input output 
coordinator (TIOC) during a 
dialup to request a logon. 
This bit is reset by the 
time sharing control task 
(TSC) . 

TJBIWAIT: Bit 3 set 
indicates that the terminal 
job is in an input wait 
state . 

TJBOWAIT: Bit 4 set 
indicates that the terminal 
job is in an output wait 
state . 
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.... .1.. TJBSILF: Bit 5 set 

indicates that the user is 
to be logged off the system,. 
This bit is set by the 
IKJSILF subroutine and 
tested by the region control 
task (RCT) restore routine 
that posts the logon ECB. 
This bit is tested and reset 
by the logon/logoff routine. 

.... ..1. TJBDISC: Bit 6 set 

indicates that a request has 
been made to the terminal 
input output coordinator 
(TIOC) to disconnect the 
line. 

.... ...x Bit 7 is reserved for future 

use. 

STAT 2 hh 

These flags indicate the status of the 
time sharing job. 

1 TJBHUNG: Bit set 

indicates that the user's 
communication line 
disconnected. 



.1. 



..1. 



.1 



1.. 



TJBHOLD: Bit 1 set 
indicates that an output 
wait (OWAIT) exists because 
of a hold option. 

TJBOCAB: Bit 2 set 
indicates an out-of-main 
storage abnormal termination 
has occurred for this user. 

TJBRNAV: Bit 3 set 
indicates that the user 
cannot be logged onto the 
time sharing system because 
(1) a machine check occurred 
in the user's region or (2) 
the region is too small for 
the user. 

TJBSURSV: Bit 4 set 
indicates that on the next 
swap in the swap unit is not 
marked as available for the 
user. 



UMSM hhhhhhhh 

The address of the user main storage 
map (UMSM) for this job. 

SDCB hhhhhhhh 

The address of the swap data control 
block (DCB) for this job. 



UTTMQ hhhh 
1... . 



TJBUTTMP: Bit of byte 
set indicates a parallel 
swap. 



.111 1111 Bits 1 through 7 of byte 
along with byte 1 contain 
the offset into the map 
queue. The map queue 
contains a chain of 
allocation units for this 
user on the swap data set. 
The address of the queue is 
in the UTTMQ field of the 
TSO region control block 
(RCB) . 

RSTOR hh 

This field contains the status flags 
used by the region control task (RCT) 
restore operation. 



1... 



.x. 



TJBOWP: Bit set indicates 
to the terminal input output 
coordinator (TIOC) to end 
the output wait (OWAIT) 
condition. 

TJBIWP: Bit 1 set indicates 
to the terminal input output 
coordinator (TIOC) to end 
the input wait (IWAIT) 
condition. 

Bit 2 is reserved for future 
use. 

TJBLOGP: Bit 3 set 
indicates that the event 
control block (ECB) waited 
for by the logon image 
should be posted. This flag 
is set by the time sharing 
control task (TSC) logon 
routine and by the IKJSILF 
subroutine. 



.... . xxx Bits 5 through 7 are 

reserved for future use. 

EXTNT hhhhhhhh 

The address of the terminal job block 
extension (TJBX) when it is in main 
storage. 

RCB hhhhhhhh 

The address of the region control 
block (RCB) for this job. 



1... TJBLWAIT: Bit 4 set 

indicates that if the user 
is not made ready by restore 
processing, he should be 
swapped out again. 

.x.. Bit 5 is reserved for future 
use. 

-.1. TJBFAT: Bit 6 set indicates 
that an attention exit is 
requested for this user's 
job. 
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.x Bit 7 is reserved for future 
use. 



UMSMN hh 

The number of entries in the user main 
storage map (UMSM). 



.. TJBMSES: Bit 2 set 
indicates that, when a 
terminal session is 
initiated or terminated a 
message is displayed on the 
operator console. 



USER cccccccc 

The userid of the user who owns this 
job. This field may have trailing 
blanks when the user identification 
contains less than eight characters. 



IPPB hhhhhhhh 

An address pointer to the beginning of 
a chain of inter-partition post blocks 
that indicate the event control blocks 
(ECBs) to be posted by the restore 
operation. 



NEWID hh 

Identifies the region where the user 
should be logged on. When this field 
is zero, the TSO driver should select 
the region. When this field is set by 
the end-of -routine for logon/logoff, 
it identifies the new region to which 
the user will be shifted. 



.1 . TJBMSPA: Bit 3 set 

indicates that the available 
space on a direct access 
device is to be displayed on 
the operator console as part 
of the demount message. 



1... TJBMSTA: Bit 4 set 

indicates that, at the end 
of a job or job step,, 
certain data set disposition 
information should be 
printed with the demount 
messages. These 
dispositions are: KEEP,, 
CATLG, or UNCATLG. 

.... .xxx Bits 5 through 7 are 

reserved for future use. 

RSV hhhhhh 

Reserved for future use. 



FLUSL hh 

Reserved for future use. 



TJID hhhh 

This field contains the terminal job 
identification (TJID) for this time 
sharing job. 

MONI hh 

These flags indicate various 
processing functions that cause 
operator messages to be sent to this 
terminal. The flags are set and reset 
when the terminal user issues the 
MONITOR subcommand of the OPERATOR 
command. 



TJBMDSN: Bit set 
indicates that the first 
non-temporary data set 
allocated to a new volume 
should be displayed as part 
of the mount and keep 
messages. 

TJBMJBN: Bit 1 set 
indicates that the name of 
each job is to be displayed 
on the console when each job 
is initiated and terminated, 
and that the unit record 
allocations are to be 
displayed when a job step is 
initiated. 



TERMINAL STATUS BLOCK (TSB) FORMATTING : 
Each terminal status block (TSB) contains 
status information about one terminal user. 
The terminal input output coordinator 
(TIOC) uses this information. During 
system initialization, one TSB is created 
for each possible user. The main storage 
space is obtained in one contiguous block 
for all of the TSBs in the region of the 
time sharing control task (TSC) ; this 
contiguous string of TSBs is called the TSB 
table. The origin pointer to the TSB table 
is the TIOCTSB field in the TIOCRPT. 

TSB hhhhhh 

The address of this terminal status 
block (TSB). 

STAT hh 

This field contains the terminal 
status indicator flags. 

1... .... TSBINUSE: Bit set 

indicates that this TSB is 
being used. 

.1.. TSBLWAIT: Bit 1 set 

indicates that the terminal 
keyboard is locked due to a 
lack of input buffer space. 

..1. TSBDSPLY: Bit 2 set 

indicates that this TSB 
represents a terminal which 
is a graphic device. 
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,1 .... TSBNOBUF: Bit 3 set 

indicates that TPUT found no 
time sharing buffers. 



. 1... TSBITOFF: Bit 4 set 

indicates that this user 
wishes to prevent 
inter-terminal 
communications. 



1.. TSBDISC: Bit 5 set 

indicates that this TSB has 
been processed by logoff. 



.x. 



Bit 6 is reserved for future 
use. 

1 TSBATNLD: Bit 7 set 

indicates an attention for 
an input line deletion. 



TJB hhhhhh 

The address of the time sharing job 
block (TJB) currently used by this 
terminal. This field contains zeros 
when this terminal is not associated 
with a time sharing job block. 

FLG1 hh 

This field contains terminal status 
flags. 

1... TSBANSR: Bit set 

indicates that an attention 
simulation is requested. 

.1.. .... TSBOFLSH: Bit 1 set 

indicates that the output 
trailer queue is to be 
flushed. This bit is set by 
TCLEARQ. 

..1. .... TSBOWIP: Bit 2 set 

indicates that a TPUT 
operation is in progress. 

...1 .... TSBWOWIP: Bit 3 set 

indicates that a task is 
waiting for another task to 
complete a TPUT operation. 

. 1... TSBIFLSH: Bit 4 set 

indicates that an input 
queue flush is in progress. 

1. . TSBTJOW: Bit 5 set 

indicates that this user is 
already using the maximum 
number of output buffers 
that can be allocated. This 
TSB waits on event control 
block (ECB) for this TCB. 
This bit is set by a TPUT 
macro instruction with a 
terminal job identification 
(TJID). 



.... . .x. Bit 6 is reserved for future 

use. 

.... ...1 TSBTJBF: Bit 7 set 

indicates that no time 
sharing buffers were 
available when the SVC for 
TPUT with the terminal job 
identification (TJID) was 
issued. The system waits 
for the TJB event control 
block (ECB) to be posted. 

WTSB hhhhhh 

Reserved for future use. 

LNSZ hh 

The number of characters that can be 
printed on one line for this terminal. 
This field is set by either logon or 
STSIZE. 

OTBFP hhhhhh 

The address of the trailer buffer if 
the heading buffer for a message has 
been removed from the message queue. 
This field is reset to zeros when the 
message has been completely moved to 
the TCAM buffers. 

NOBF hh 

The number of buffers on the output 
queue . 

OBFP hhhhhh 

The address of the first buffer on the 
output buffer queue. 

BRKFL hh 

These flags indicate the status of the 
communication line. 

1 ... TSBBIPI: Bit set 

indicates to the TSINPUT 
that a partial line exists 
for prompting. Set by 
TSOUTPUT. 

.1.. . TSBAUTON: Bit 1 set 

indicates that automatic 
input line numbering is 
requested. 

..1. .... TSBBRKIN: Bit 2 set 

indicates that TPUT is using 
the breakin option and a 
partial line was assigned to 
this function. This bit is 
set by TSINPUT. TSINPUT is 
a TCAM subtask. 

...1 .... TSBAULST: Bit 3 set 

indicates that automatic 
line numbering has started. 

.... 1... TSBAUTOC: Bit U set 

indicates that automatic 
character prompting is used. 
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..... .1.. TBSTAUT: Bit 5 set 

indicates that the user is 
being prompted with the next 
line number. 

.... ..11 TSBSATN1: Bits 6 and 7 

contain a count of the 
number of characters used to 
simulate attention,. 

ITBFP hhhhhh 

The address of the first buffer in the 
trailer input buffer chain. 



NIBF 



The number of buffers on the input 
queue. 



IBFP hhhhhh 

The address of the first buffer in the 
input buffer queue chain. 

CLEAR hh 

This field contains terminal status 
flags. 

1 .... TSBATTN: Bit set 

indicates that an attention 
from this terminal has been 
ignored. 

.1 TSBTJMSG: Bit 1 set 

indicates that TSOUTPUT is 
processing a terminal job 
identification (TJID) 
message. 

..1. .... TSBSPIT: Bit 2 set 

indicates that breakin 
prompt and automatic prompt 
are suppressed. 

...1 .... TSBNBKSP: Bit 3 set 

indicates that the next 
character in the user * s 
buffer is a backspace 
character. 

.... xxxx Bits H through 7 are 

reserved for future use. 

QCB hhhhhh 

The address of the queue control block 
(QCB) that contains the destination 
for the message being sent. 

ECB hhhhhhhh 

The event control block (ECB) at which 
the inter-terminal communication (TPUT 
with TJID) waits (1) when there are no 
time sharing buffers, (2) when the 
TSBOWIP bit is set, or (3) when the 
TSBOQHLD bit is set. 

TJID hhhh 

The terminal job identification (TJID) 
of the task waiting on this TCB's 
event control block (ECB). 



STCC hhhh 

These two bytes define special purpose 
characters that may be redefined by 
the terminal user. 

byte 

TSBLNDCC: This byte contains the line 
delete character. 

byte 1 

TSBKSPCCj This byte contains the 
character delete character. 

ATNLC hhhh 

The number of successive lines of 
printed output between attention 
simulation reads. 

ATNTC hhhh 

The number of seconds between 
attention simulation reads. 

LNNO hh 

When a graphic terminal device is 
used, this is the number of line that 
can be displayed. 

BLNK hh 

Reserved for future use. 

ASRCE hhhh 

This field contains the same 
information as the PRFSRCE field in 
the TCAM buffer prefix,. 

ATNCC cccc 

This field contains from one to four 
characters that are used to simulate 
attention. Some of the character 
positions may contain blanks,. 

AUTOS hhhhhhhh 

This field initially contains the 
starting line number for the first 
input line. While the line of input 
information is being received from the 
terminal user, this field is updated 
to contain the value of the current 
line number. 

AUTOI hhhhhhhh 

This field contains the value that is 
used to automatically increment the 
value of the input line numbers. This 
field can be modified by the terminal 
user. 

ERSDS cccc 

When a graphic terminal device is 
used, this word contains the 
characters used to erase the display 
screen. 

TIME SHARING JOB BLOCK EXTENSION (TJBX) 
FORMATTING : The time sharing job block 
extension (TJBX) contains user job 
information that can be rolled out to the 
swap data set with the user's job. The 
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TJBX resides in the local system queue 
space (LSQS) for the region. The TJBX 
location is pointed to by the third word of 
the time sharing job block (TJB) . The 
space for the TJBX is obtained by the 
region control task (RCT) during 
initialization. 



TJBX hhhhhh 

The address of the TJBX. 



XFST hhhhhhhh 

The address of the logon TCB. The 
logon TCB is the first TCB on the 
user's ready queue. 



XLAST hhhhhhhh 

The address of the last TCB on the 
user's ready queue. 

XDSE hhhhhhhh 

The address of the data set extension 
(DSE) used by TSO dynamic allocation- 

XSVRB hhhhhhhh 

The address of the first supervisor 
request block (SVRB) purged from the 
transient area queue. 

XRQE hhhhhhhh 

The address of the first request queue 
element (RQE) purged from the 
asynchronous exit queue. 

XIQE hhhhhhhh 

The address of the first interrupt 
queue element (IQE) purged' from the 
asynchronous exit queue. 

TAXE hhhhhhhh 

The address of the queue of terminal 
attention exit elements (TAXEs) used 
to schedule the attention exits. 

XLECB hhhhhhhh 

The logon event control block (ECB) 
that was posted by the region control 
task (RCT) to activate logon/logoff. 

XPSWD cccccccc 

The password entered by the terminal 
user during logon. If the password 
contains less than eight characters, 
the field is padded to the right with 
blanks. The entire field contains 
blanks when the user is not required 
to enter a password. 

RSV hhhhhhhh 

Reserved for future use. 

XAIQE hhhhhhhh 

The address of the attention interrupt 
queue element (IQE) currently being 
processed by the attention prologue. 



XQPL hhhhhhhh 

The address of the quiesce parameter 
list (QPL). 

XNQPE hhhh 

The number of entries in the quiesce 
parameter list (QPL). 

XNTCB hhhh 

The number of task control blocks 
(TCBs) active in the user's job step. 
When the value in XNTCB exceeds XNQPE,, 
the quiesce parameter list is 
enlarged. 

XLQPL hhhh 

The number of bytes in the quiesce 
parameter list. 

HBFL hhhh 

Reserved for future use. 

XACT hhhhhhhh 

The relative track and record address 
(TTR) for the account control table 
(ACT) on SYSJOBQE. 

XAECB hhhhhhhh 

This field contains either: (1) The 
address of the logon/logoff event 
control block (ECB) when logon 
processing begins. (2) The address of 
the command scheduling block (CSCB's) 
cancel event control block (ECB) after 
the CSCB is created. 

XKEYA hhhhhhhh 

The address of the storage key save 
area. 

PROTECTED STEP CONTROL BLOCK (PSCB) : The 
protected step control block (PSCB) 
contains accounting information related to 
a single user. All timing information is 
in software timer units. A software timer 
unit is equal to 26.04166 microseconds. 

PSCB hhhhhh 

The address of this PSCB. 

USER ccccccc 

These seven bytes contain the userid 
entered by the terminal user during 
logon. If necessary, it is padded to 
the right with blanks. This field 
uniquely identifies each terminal user 
in the time sharing system. 

USRL hh 

The number of nonblank characters in 
the userid. 

GPNM cccccccc 

An eight -byte group name initialized 
by logon from the user attribute data 
set (UADS). When a name is not 
available from UADS, the unit name 
used by the dynamic allocation 
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interface routine (DAIR) is used, if a 
name is required. 



ATR1 hhhh 

Sixteen bits used to define terminal 
user attributes. 



byte 
1... 



1 . , 



PSCBCTRL: Bit set 
indicates that the user may 
use the OPERATOR command. 

PSCBACCT: Bit 1 set 
indicates that the user may 
use the ACCOUNT command. 

PSCBJCL: Bit 2 set 
indicates that the user may 
use the SUBMIT, STATUS, 
CANCEL, and OUTPUT commands. 



.x xxxx Bits 3 through 7 are 

reserved for future use. 



.1. .; 



RLGB hhhhhhhh 

The address of the re-logon buffer 
block used by logon as a pointer to 
the re-logon command buffer. 



UPT hhhhhhhh 

The address of the user profile table 
(UPT). 

UPTL hhhh 

The number of bytes in the user 
profile table. 

RSV1 hhhh 

RSV2 hhhhhhhh 

RSV1 and RSV2 are a single six byte 
field that is reserved for future use. 

USE1 hhhhhhhh 

USE2 hhhhhhhh 

USE1 and USE2 are a single eight byte 
field reserved for use by IBM 
customers. 



byte 1 

Reserved for future use. 

ATR2 hhhh 

bytes and 1 

Reserved for use by IBM customers. 

CPU hhhhhhhh 

The cumulative CPU time used by this 
terminal user during this session. 
The CPU field is set to zero during 
logon. 

SWP hhhhhhhh 

The cumulative time that this terminal 
user has been resident in the region- 
The SWP field is set to zero during 
logon. 

LTIM hhhhhhhh 

The actual time of day that this user 
logged on to the time sharing system 
for this session. 

TCPU hhhhhhhh 

The total CPU time used by this 
terminal user, excluding the current 
session. 

TSWP hhhhhhhh 

The total time that the terminal user 
has been resident in the region during 
this accounting period, excluding the 
current session. 

TCON hhhhhhhh 

TC01 hhhhhhhh 

TCON and TC01 are a single eight byte 
field. This field contains the total 
connect time for this terminal user 
during this accounting period, 
excluding the current session. 



TERMINAL ATTENTION EXIT ELEMENT (TAXE) 
FORMATTING : The TSO terminal attention 
exit element (TAXE) consists of a regular 
24 word interrupt request block (IRB) plus 
a TSO addendum. It is used to schedule an 
attention exit resulting from a terminal 
attention interruption. It is created, 
queued, and dequeued by the specify 
terminal attention exit (STAX) macro 
instruction. The main storage space for 
the TAXE is obtained in the local system 
queue space (LSQS) of the terminal user's 
region. 

TAXE hhhhhh 

The address of this TAXE when it is in 
main storage. 

TMFLD hh 

This field contains indicators for the 
time routines. 

1... .... Bit set indicates that the 

timer element was not 
queued. 

.1.. .... Bit 1 set indicates that the 

local time-of-day option is 
used. 

..00 .... Bits 2 and 3 set to 

zero-zero indicate that the 
time interval was requested 
in timer units (26.04166 
microseconds) . 

..01 .... Bits 2 and 3 set to zero-one 
indicate that the time 
interval was requested in 
binary units. 

..10 .... Reserved for future use. 
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. . 11 - . . . Bit. 2 and 3 set to one-one 
indicate that the time 
interval was requested in 
decimal digits. 

.... 1... Bit 4 set indicates that the 
time interval has expired. 

.... .000 Bits 5 through 7 set to 

zero-zero-zero indicate an 
STIMER task time request. 

.... .001 Bits 5 through 7 set to 

zero-zero-one indicate an 
STIMER wait request. 

.... .011 Bits 5 through 7 set to 
zero- one- one indicate an 
STIMER REAL time request. 

.... » 100 Bits 5 through 7 set to 

one-zero-zero indicate an 
STIMER task time request 
with a specified exit. 

.... . Ill Bits 5 through 7 set to 
one-one-one indicate an 
STIMER REAL time request 
with a specified exit. 

Other combinations of bits 5 through 7 
are reserved for future use. 

PPSAV hhhhhh 

The starting address of the register 
save area for the problem program. 

ABOPSW hhhhhhhh 

This field displays the right half 
(bytes 4 through 7) of the program 
status word (PSW) that was active in 
the dump system during the execution 
of an ABEND or ABTERM routine. If 
these routines have not been invoked , 
then this field contains zeros. 

WCSA hh 

The number of requests waiting when 
termination occurred. 

SIZE hh 

The number of doublewords in this 
request block. 

STAB hhhh 

This field contains two bytes of 
status and attribute information. 



byte 1 

This byte contains various request 
block indicators. 



1... ..... Bit set indicates that the 

RBLINK field points to the 
task control block (TCB) . 



.1.. .... Bit 1 set indicates that the 

program related to the 
interrupt request block 
(IRB) is active. 



,1. .... Bit 2 set indicates that 

this interrupt request block 
(IRB) is for an exit routine 
(ETXR). 

, .x .... Bit 3 is reserved for future 
use. 

, .. 00.. Bits 4 and 5 set to 

zero-zero indicate that the 
request queue element (IQE) 
is not to be returned. 

, .. 01.. Bits 4 and 5 set to zero-one 
indicate that the interrupt 
request block (IRB) has 
queue elements for 
asynchronously executed 
routines that are request 
queue elements (RQEs) . 

,.. 10.. Bits 4 and 5 set to one-zero 
indicate that an interrupt 
queue element (IQE) is not 
to be returned at EXIT. 

... 11.. Bits 4 and 5 set to one-one 
indicate that the interrupt 
request block (IRB) has 
queue elements for 
asynchronously executed 
routines that are interrupt 
queue elements (IQEs). 

. . ..1. Bit 6 set indicates that the 
request block storage can be 
freed at exit. 

, .. ...0 Bit 7 set to zero indicates 
a wait for a single event or 
all of a number of events. 



byte 

The TAXE is a type of interrupt 
request block (IRB). Byte zero 
identifies the type of request block; 
however, for the TAXE, only the IRB 
identification is used. 
01.. .... Bits and 1 set to zero-one 

indicate that this is an 
interrupt request block 
(IRB) . 



...1 Bit 7 set to one indicates a 
wait for a number of events 
that is less than the total 
number of events that are 
waiting. 



EP hhhhhhhh 

The address of the routine that was 
asynchronously executed. 
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LOPSW hhhhhhhh (Left half of PSW) 
ROPSW hhhhhhhh (Right half of PSW) 
This program status word (PSW) 
contains the status of the program 
represented by the request block being 
displayed when a new request block was 
created. Had the dumped system been 
allowed to continue processing 
normally, the operation would have 
been resumed with this PSW. 

USE hh 

This field contains the use count as 
used by ATTACH. 

IQE hhhhhh 

The address of the list origin for the 
interrupt queue element (IQE). 

WCF hh 

The number of requests that were 
pending when this dump was taken. 

LINK hhhhhh 

The address of the next request block 
(RB) on this RB queue. If this is the 
last request block on the queue, then 
this field contains the address of the 
task control block (TCB). 

GRO hhhhhhhh 



GR15 hhhhhhhh 

The general register save area used by 
the supervisor. 

NIQE hhhhhhhh 

The address of the next available 
interrupt queue element (IQE). 

LNK hhhhhhhh 

The address of the next interrupt 
queue element (IQE). 

PRM1 hhhhhhhh 

The address of the parameter list for 
the asynchronous exit routine. 

IRB hhhhhhhh 

The address of the interrupt request 
block (IRB) to be scheduled next. 

TCB hhhhhhhh 

The address of the task control block 
(TCB) for this TAXE. 

TLNK hhhhhhhh 

The address of the next TAXE on this 
queue. 

XPSW hhhhhhhh 

The left half (bytes through 3) of 
the program status word (PSW) for the 
user attention exit routine. 



EXIT hhhhhhhh 

The address of the user attention exit 
routine. 

STAT hhhhhhhh 

This field contains status flags for 
this TAXE. 



byte 
1... 



.1.. . 



. TAXEFKEY: Bit set 
indicates that the task 
issuing the specify terminal 
attention exit (STAX) macro 
instruction is a problem 
program.. 

. TAXEMOD: Bit 1 set 
indicates that the task 
issuing the specify terminal 
attention exit (STAX) macro 
instruction is in problem 
program mode. 

. TAXEFFREQ: Bit 2 set 

indicates that the requested 
TAXE is not available for 
scheduling,. 



...x xxxx Bits 3 through 7 are 

reserved for future use. 

bytes 1-3 

Reserved for future use. 

PARM hhhhhhhh 

The address of the parameter list for 
the specify terminal attention exit 
(STAX) macro instruction. 

TAIE hhhhhhhh 

The address of the terminal attention 
interrupt element. 

IBUF hhhhhhhh 

The address of the user input buffer. 

USER hhhhhhhh 

The address of the user parameter list 
from the specify terminal attention 
exit (STAX) macro instruction. 

Task Control Block Summaries 

If, during the course of program execution, 
the IMDPRDMP program formatted the major 
system control blocks of more than one MVT 
or MFT task, a summary of each displayed 
task*s TCB is presented at the end of the 
control block portion of the dump listing. 
Depending upon the operating system option 
under which the dumped task was operating, 
either the MVT/MFT-with-subtasking TCB 
summary format (Figure 25) , or the abridged 
MFT- without-subtas king TCB summary format 
(Figure 26) is presented. 

Both summary formats are identified by 
two lines of heading information. The 
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first heading line displays the optional 
dump listing title,, the name of the module 
that invoked the dump, and the date and 
time that the information was captured from 
the dumped system- The second line of 
heading displays the identifying phrase 
****** TCB SUMMARY ****„" 

The individual TCB summaries contain the 
following information: 



MVT or MPT with Subtaskinq TCBs ; Are 
summarized in the two- line array 
illustrated in Figure PROUT-9 and described 
below : 

JOB cccccccc 

The JOB field in the first line of 
each task control block array displays 
to the user the eight- character name 
of the job associated with the TCB. 

STEP cccccccc 

The STEP field shows the eight- 
character name of the job step as it 
appeared on the label field of the 
EXEC JCL statement associated with the 
step. 

TCB hhhhhh 

The starting address of the task 
control block. 

CMP hhhhhhhh 

This field shows the ABEND indicators 
and user and system completion codes 
associated with this TCB. (See the 
relevant TCB discussion for the 
contents of this field. ) 

NTC hhhhhhhh 

This word contains the address of the 
TCB that occurred previous to this one 
on the originating task's subtask 
queue. If the TCB being summarized 
was the first on the queue, this field 
displays zeros. 

OTC hhhhhhhh 

The OTC field displays the address of 
the TCB representing the originating 
task. 



LTC hhhhhhhh 

This field contains the address of the 
TCB that occurred last on the 
originating task* s subtask queue at 
the time the dump was taken. If the 
TCB being summarized was the last on 
the subtask queue, this field contains 
zeros. 

PAGE ddd 

The page of the dump listing on which 
the formatted control blocks 
associated with this TCB, may be 
found . 



MFT Without Subtaskinq TCBs ; Are 
summarized in the two line abridged array 
illustrated in Figure PROUT-10 and 
described below: 

JOB cccccccc 

The JOB field in the first line of 

each task control block array, 

displays to the user the 

eight -character name of the job 

associated with the TCB being 

summarized. 

STEP cccccccc 

The STEP field shows the 
eight -character name of the job step 
as it appeared in the label field of 
the EXEC JCL statement associated with 
the step. 

TCB hhhhhh 

The starting address of the task 
control block being summarized is 
given in the first field of this 
second line. 

CMP hhhhhhhh 

This field shows the ABEND indicators 
and user and system completion codes 
associated with the TCB. (See the MFT 
TCB discussion for a description of 
the contents of this field.) 

PAGE ddd 

The page of the dump listing on which 
the formatted control blocks 
associated with this TCB, are found. 
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MODULE IMDSAOMP DATE 11/12/70 TIME 00.15 


PAGE 0032 












* * * * 


TCB SUM 


MARY * * 


* * 




JOB 


TCB 


STEP 

0085E8 CMP 


OOOCOOOO 


NTC 


COOOOOOO 


OTC 00009CA0 


LTC 00000000 


PAGE 0004 




JOB 


TCB 


STEP 
008728 CMP 


OCOCOCOO 


NTC 


00000000 


OTC 00009CAO 


LTC 00000000 


PAGE 0005 




JIB 


TCB 


STEP 
008868 CMP 


OCOOOOOO 


NTC 


00000000 


OTC 00009CA0 


LTC 00000000 


PAGE 0006 




JOB 


TCB 


STEP 
0089A8 CMP 


OOOCOOOO 


NTC 


00000000 


OTC 00009CA0 


LTC 00000000 


PAGE 0007 




JOB 


TCB 


STEP 
008AE8 CMP 


00000000 


NTC 


00000000 


OTC 00009CA0 


LTC 00000000 


PAGE 0008 




JOB 


TCB 


STEP 
008C28 CMP 


OOOOOCOO 


NTC 


00000000 


OTC 00009CA0 


LTC 00000000 


PAGE 0009 




JOB 


TCB 


STEP 
008D68 CMP 


OOOOCOOO 


NTC 


00000000 


OTC 00009CA0 


LTC 00000000 


PAGE 0010 




J3B 


TCB 


STEP 
008EA8 CMP 


OOOOOCOO 


NTC 


COOOOOOO 


OTC 00009CA0 


LTC 00000000 


PAGE 0011 




JOB 


TCB 


STEP 
008FE8 CMP 


OOOOCOOO 


NTC 


COOOOOOO 


OTC 00009CAO 


LTC 00000000 


PAGE 0012 












~ 





















MODULE IMDSADMP DATE 11/12/70 TIME 00.15 


PAGE 0033 








* * * * 


TCB SUM 


MARY * * 


* * 






JOB 


MASTER STEP SCI-EOULR 
TCB 009CA0 CMP OOOCOCOO 


NTC 


OOOCOOOO 


OTC 00000000 


LTC 0002E268 


PAGE 


0022 




JOB 


MASTER STEP SCHEDULR 
TCB 0288C8 CMP 00000000 


NTC 


00009BA8 


OTC 00009CA0 


LTC 00000000 


PAGE 


0025 




JOB 


J0B4 STEP GO 
TCB 02E0F8 CMP 00000000 
TCB 02D1E8 CMP COOOOOOO 
TCB 02D400 CMP COOOOCOO 


NTC 
NTC 
NTC 


000288C8 
00000000 
00000000 


OTC 00009CA0 
OTC 0002E0F8 
OTC 0002D1E8 


LTC 0002D1E8 
LTC 0002D400 
LTC 00000000 


PAGE 
PAGE 
PAGE 


0027 
0028 
0029 




JOB 


WTR STEP CCE 

TCB 02E268 CMP OCOOOOOO 

TCB 02D108 CMP OOOOCOOO 


NTC 
NTC 


C002E0F8 
00000000 


OTC 00009CA0 
OTC C002E263 


LTC 0002D108 
LTC 00000000 


PAGE 
PAGE 


0030 

0031 — 

















Figure 25. TSB Summary Sample for System That Operated Under MVT or MFT With Subtasking 
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MFT 


OUMP LISTING 




* * * * T 


MODULc IMOSAOMP DATE 11/12/70 TIME CO. 50 
CB SUMMARY **** 


PAGE 0C22 


JOd 


STEP 
TCB 008 778 CMP 


OOOOCCOC 


PAGE 0001 






J 03 


MASTER STEP SCHcDULR 
TCB 008358 CMP 00CC0000 


PAGE 0002 






JOd 


STEP 
TC8 008938 CMP 


OOOCCCOC 


PAGE 0004 






JOd 


STEP 
TCB 008Aid CMP 


OOOCOOOC 


PAGE 0005 






JOd 


MASTER STEP SCHEDULR 
TCB 00836d CMP OOCOOCOC 


PAGE 0C06 






JOd 


MASTER STEP SCHcDULR 
TCB 008C4d CMP OOOOCOOC 


PAGE 0007 






JOd 


WTR STEP PO 
TCB 008J4d CMP 


OOOOCOOC 


PAGE 0C09 






JJd 


STEP 
TCB 008F4d CMP 


OOCOOCOO 


PAGE 0010 






JOd 


J0B5 STEP GO 
TCB 009148 CMP 


00000000 


PAGE C011 






JJd 


STEP 
TCB 009348 CMP 


occcococ 


PAGE 0013 






JJd 


STEP 
TCB 00954d CMP 


oooooccc 


PAGE 0014 






JOd 


STEP 
TCB 009 748 CMP 


OOOCCOOC 


PAGE 0015 






JOd 


STEP 
TCB 009 S48 CMP 


OOOOOCOC 


PAGE 0016 






JOd 


STEP 
TCB 009348 CMP 


OOCOOCOO 


PAGE 0017 






JOd 


STEP 
TCB C09048 CMP 


00000000 


PAGE 0018 






JOd 


STEP 
TCB 009F48 CMP 


ooococoo 


PAGE 0019 






JOd 


STEP 
TCB 00A148 CMP 


OCOOOOOC 


PAGE 0020 






JOd 


STEP 
TCd 00A346 CMP 


OOCCCOOC 


PAGE 0021 







Figure 26. TCB Summary Sample for Systems that Operated Under MFT Without Subtasking 



THE GENERAL FORMAT 

The IMDPRDMP program uses a general format 
to display the hexadecimal contents of main 
storage. The particular areas of main 
storage displayed are determined by the 
parameters entered after the PRINT user 
control verb. 

To identify various dump printouts,, 
IMDPRDMP prints specific headings on each 
dump,, such as ALLOCATED STORAGE, PRINT 
STORAGE,, and NUCLEUS and SQA PRINT. A 
sample of a general format dump is shown in 
Figure 27. 

The IMDPRDMP program also reverts to the 
general format if it is unable to format 
control block information because it 
encountered either a control block error or 
one of several user control statement 
format errors. 

Each page of an IMDPRDMP program dump 
listing containing information displayed in 
the general format is identified by a 
heading line. This heading line shows the 
optional title supplied by the user 
followed by the date and time that the 
information was taken from the dumped 
system. A sequential page number also 
appears in each heading line. 

Listings being produced under control of 
the PRINT ALL, PRINT CURRENT, or PRINT 
STORAGE (no operands) format control 
statement display the contents of the 



sixteen general purpose registers. If the 
dump was obtained from a multiprocessing 
system and both sets of registers were 
obtained, then the contents of both sets of 
registers are displayed. Where applicable, 
the beginning of each main storage region 
is noted by a line that gives the job, step 
and procedure step name of the owning task, 
followed by the status of the region 
(BORROWED,, ROLL-OUT, OWNED). 



Then, starting at an address requested 
by the user, as specified in a PRINT user 
control statement, (or location zero if no 
address was specified) the contents of main 
storage are displayed'. Each line of the 
general format displays eight words of main 
storage. Preceding each line of 
information is the address of the first 
byte displayed followed by a one-character 
storage protection key indicator 
representing the key associated with the 
area of main storage being displayed on 
this line. Following each line of 
information, a 32-character translation 
field is printed. This field gives the 
EBCDIC translation of the translatable 
characters in the eight hexadecimal words. 
Untranslatable bytes are represented by 
positional periods. 

Printing of any line that duplicates the 
contents of the line printed previously,, is 
suppressed. Duplicate lines are indicated 
by the phrase "TO NEXT LINE ADDRESS SAME AS 
ABOVE" following the line duplicated. 
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MODULE IMDSADMP DATE ll/l2/70 TIME 00.15 "AGE 0001 



R 0-7 
R 8-15 
000000 
000020 
000040 
000060 
000080 
OOOOAO 
OOOOCO 
OOOOEO 
000100 
000120 
000160 
000180 
0001A0 
0001C0 
C001E0 
C00200 
000220 
COO 240 
000260 
000280 
C002A0 
0002C0 
0002E0 
C00300 
000320 
000340 
000360 
000380 
0003A0 
C003C0 
0003E0 
000400 
C00420 
000440 
000460 
000480 
0004A0 
0004C0 
0004E0 
000500 
000520 
000540 
000560 
000580 
0005A0 
OOO5C0 
0005E0 
000600 
000620 
000640 
000660 
000680 
0006A0 
0006C0 



00000000 
00000000 
00000191 
FFC40001 
000022E8 
982400C8 
310000A6 
00000000 
020000C8 
40404040 
61F0F161 
00000000 
00000000 
FF060009 
00009AOO 
000117E0 
OOOOOOCC 
000726D0 
00004E98 
5834002C 
30104770 
302291FF 
00041BAA 
5 084927F 
071C1812 
91011001 
0F9C1000 
47500E2A 
4BA0508C 
91102000 
477006 5C 
91082000 
066447F0 
040694E7 
50007031 
91082001 
471004D2 
D5017035 
9D006000 
00444780 
4BC05096 
20119101 
91027013 
001C58FF 
41E00DA2 
06249602 
05AE9101 
05D658A2 
41C00664 
94DF2000 
507407FB 
600005A0 
04A005CC 
509A45E0 
20090041 
70069120 



000022C8 
00000000 
00001C00 
5000BBB2 
OCOOOOOO 
9D001000 
4CC0C005 
00000000 
20000048 
40404040 
F9F94040 
00000000 
00000000 
80C00OO0 
00009AF4 
00009BB4 
000729C0 
00067594 
OOOOOOOO 
D5022015 
02724873 
700247E0 
43A7C00A 
2004501B 
58E00FC8 
47100352 
40105088 
91107C06 
50A00024 
471003E6 
58AC7030 
478003DA 
06249104 
20019110 
91012000 
471C0490 
D5017031 
A00C47C0 
47B004A0 
8008945F 
41A07031 
20004780 
47800530 
000005EF 
94FE7006 
70064060 
70064780 
00189101 
41B00624 
58F3001C 
92000048 
88A00018 
4770068E 
075207F8 
471006E4 
00444710 



OOOOOOOO 
OOOOOOOO 
40002 0B4 
FFF50004 
00002280 
00020000 
08000080 
00000450 
C2C5D5C4 
40404040 
40404040 
OOOOOOOO 
OOOOOOOO 
0000018A 
00009968 
00000040 
OOOOOOOO 
0006 5 D40 
41500800 
30194770 
00229170 
0ED491AO 
89A00003 
000094FD 
07FE4180 
4C710002 
18A0D200 
47100DE6 
18B09620 
41A05020 
91042001 
50A05030 
20014780 
20014710 
47100432 
D5037033 
A0044770 
049002 01 
48A00044 
700691A0 
40A0C002 
051CD202 
58A00048 
47F005 5C 
94DF2000 
70044010 
0DD247F0 
20004710 
50A00048 
58FF0004 
91017006 
42A20010 
96A07006 
D2C37031 
18E096A0 
80C49608 



8000214A 
OOOOOOOO 
6000002B 
A006E7C2 
00005E08 
00000003 
40000001 
00D20650 
40404040 
404040C6 
40404040 
OOOOOOOO 
82000170 
018A018A 
000099B4 
00009B74 
0006F000 
00072798 
1A551821 
0ED491F0 
70124780 
50984790 
41DA52FC 
50984580 
02D245C0 
90231004 
1008A023 
48AD0006 
B02092F0 
0200A000 
471003C0 
92085030 
05D647F0 
05709102 
02077030 
A0064740 
053E9104 
7035A008 
54A05058 
50984790 
43B07030 
C0112019 
47F005E0 
47F00554 
47F00752 
701447F0 
040E9407 
05D258A2 
91202000 
50B05074 
47800638 
58900FC0 
43907004 
50004720 
70069106 
70069140 



00002280 
OOOOOOOO 
08000080 
OOOOFFOO 
5A64336D 
9D001000 
05001G00 
445000B8 
40404040 
F0F8C107 
OOOOOOOO 
OOOOOOOO 
00040000 
FF000190 
00009AP0 
5000BCA4 
5006E596 
4006E7AE 
92825098 
00214780 
02824393 
029E58F0 
07FC4012 
02F647F0 
02A247F0 
5001000C 
45E00AD0 
07FAD502 
0977 1B9 9 
302045C0 
58A20010 
41A05028 
03889140 
70064710 
20201BAA 
053E0503 
30084780 
41A05038 
477006A8 
800818B6 
89B00004 
91082001 
45C00624 
47F00432 
58C20018 
04CA4910 
702C94DF 
001047FO 
47800604 
05EF47F0 
91102001 
05B91B99 
1A994079 
070C58A0 
00454770 
004407 IE 



OOOOOOOA 
OOOOOOOO 
40000001 
OOOOOOOO 
48100002 
47700070 
40000500 
47F0006C 
40404040 
D9F7F040 
OOOOOOOO 
OOOOOOOO 
00036D18 
FF000190 
80009B74 
6000A57A 
000729B8 
0001828C 
1B114010 
025A45E0 
001C43A2 
0FC445EF 
001ED708 
02E247F0 
03444810 
92001004 
91EF7006 
20150FD1 
58A00FBC 
05E407BC 
91012000 
D200502D 
702C4710 
04D241A0 
43A70030 
7033A00A 
0490D501 
41B00578 
96A27006 
88B00008 
439B3020 
4780051C 
077C96A6 
41E 00960 
47F0051C 
702A4770 
200047F0 
O5E0D2O0 
910C402C 
061E41E0 
4710063E 
40607004 
52F0D600 
004841A0 
0F8C9110 
91840044 



OOOOOOOO 
OOOOOOOO 
FFE 50000 
FF060009 
412000C0 
91030044 
06001C00 
D2002000 
40404040 
F0F04BF1 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
00000001 
00009AD0 
00000030 
A006E740 
OOOOOOOO 
50881804 
0E681B99 
0O2 089A0 
C00041C0 
20082008 
02EA4700 
0F9C1211 
D300100C 
47708008 
47800308 
5090A000 
48A00044 
478003C0 
701850A0 
05929101 
703140A0 
89A 00004 
4720053E 
7035A008 
45C005E8 
D2062009 
89B00002 
4290C00D 
9618C00D 
700647F0 
47F 00564 
D5037031 
0DD69148 
C40E9110 
50082018 
47800624 
096447F0 
D3000048 
40107014 
700C509A 
A00850A0 
00444780 
47808008 



OOOOOOOO 
400020B4 
900432B6 
80000000 
50200048 
4750007C 
000004BO 
00D84040 
40404040 
F140F1F4 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
FFFF6528 
4000BB62 
0006F9F4 
00000001 
OOOOOOOO 
58420014 
18A991FE 
9000487A 
02B258B2 
04032000 
000045E0 
4740035C 
0021D201 
91FF0FB0 
58AO0024 
47FC02E2 
54A05058 
58A20018 
004841C0 
70064770 
50 3AD203 
41AA3020 
91027013 
4740048A 
47700688 
00419104 
48CB52D4 
D202C011 
50C00048 
066C58F3 
92422004 
50004770 
702C4710 
20004710 
41A05008 
943F402C 
075258B0 
100C9C00 
58A02010 
D7C0700C 
0040D206 
0714945F 
41808004 
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Figure 27. Sample of General Format Dump 



OUTPUT COMMENTS 

The following output comments are printed 
within the body of a formatted dump 
whenever IMDPRDMP is unable to locate, 
format and print a control block. These 
comments explain why the referenced control 
block is not printed within the dump 
listing, these output comments are 
separated from the main storage information 
by a blank line both before and after each 
output comment. Note: Output Comments 
produced when IMDPRDMP is processing GTF 
output are shown in Section 3 of this 
publication under the heading * IMDPRDMP 
Output Comments - GTF Processing 1 . 

DUPLICATE PREFIX FOLLOWS - ID •A 1 

Explanation : While processing a 
dump from a Model 65 
multiprocessing system, IMDPRDMP 
has determined that the CPU 
prefixes (CPUIDs) are the same. 
If the task that performs the dump 
is initiated on one CPU, 
interrupted, dispatched to the 
second CPU, and completed the rest 
of the processing on the second 
CPU, then the prefix shown in this 
output comment is that of the 
first CPU to which the task was 
assigned. Processing continues. 

END OF FILE ON DUMP TAPE 

Explanation : While trying to 
locate a block of main storage on 
the dump tape, IMDPRDMP reached 
the end of the tape. This message 
is printed only if IMDPRDMP is 
either trying to extract the CVT 
pointer or trying to extract an 
area of storage for printing. 

Processing terminates. If 
IMDPRDMP did no formatting and the 
tape does not contain a low- speed 
dump produced by IMDSADMP, the job 
may be rerun using the CVT control 
statement to direct IMDPRDMP to 
the CVT in this dump. Low- speed 
dumps produced by IMDSADMP can not 
be formatted by IMDPRDMP. 



• IMDPRDMP found (1) a TCB 
family chain pointer, (2) a 
partition queue element (PQE) 
pointer (TCB + X'98*), or (3) 
a pointer within a PQE that: 

1. Addressed an area that was 
not on a word boundary; 
or, 

2. Addressed an area that was 
higher than the highest 
address in the dump; or, 

3. Could not be extracted 
from the dump decause 
either an I/O error was 
encountered while 
attempting to read the 
block containing the 
pointer or the block 
containing the pointer was 
missing from the dump; a 
possible cause for a 
missing block is that the 
routine that produced the 
dump encountered an I/O 
error while attempting to 
write the block. 

Processing continues. 



ERROR FORMATTING TCB 



Explanation : One of the fields in 
the TCB required for formatting 
could not be extracted from the 
dump because: 

• IMDPRDMP encountered an I/O 
error while attempting to read 
the block that contains the 
required data; or, 

• The block containing the 
required data was missing from 
the dump; a possible cause is 
that the routine that produced 
the dump encountered an I/O 
error while attemtping to 
write the block. 

Processing continues. 



ERROR IN DEB CHAIN 



ERROR FINDING REGION BOUNDARIES FOR 
TCB aaaaaa. 

Explanation : While attempting to 
determine the region boundaries 
for the family of TCBs attached to 
the job step TCB at address 
aaaaaa, one of the following 
conditions occurred: 

• IMDPRDMP found a chain with 
more than fifty partition 
queue elements (PQEs) ; or, 



Explanation : The routine that 
formats the data extent block 
(DEB) found one of the following 
errors : 

• A DEB chain pointer: 

1. Was not on a word 
boundary; or, 

2. Addressed an area of main 
storage higher than the 
highest address in the 
dump; or. 
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The address of the DEB was 
invalid causing the address of 
the DEB prefix (DEB - 16) to 
be zero or negative; or, 



• A DEB chain pointer or one of 
the fields necessary to format 
the DEB could not be extracted 
from the dump because: 

1. IMDPRDMP encountered an 
I/O error attempting to 
read the block that 
contained the data; or f 

2. The block containing the 
data was missing from the 
dump; a possible cause is 
that the routine that 
produced the dump 
encountered an I/O error 
while attempting to write 
the block. 

Processing continues. 

ERROR IN EXTENT LIST 

Explanation : While formatting the 
load list or job pack area of an 
MVT dump, IMDPRDMP encountered a 
contents directory entry (CDE) 
that had a block extent list with 
a relocation factor (extent list + 
4) of zero or greater than 
twenty-five. A relocation factor 
of zero is an error; however, a 
value greater than twenty-five can 
be valid. The value of 
twenty-five was established by 
IMDPRDMP as a reasonable limit; it 
is improbable that a normal task 
would have a program that has more 
than twenty-five CSECTs causing it 
to get an extent list with a 
relocation factor greater than 
twenty-five. Processing continues 
with the next CDE. 

ERROR IN JOB PACK QUEUE 

Explanation : The routine that 
formats the job pack area 
encountered one of the following 
errors : 

• A job pack queue chain pointer 
addressed an area that: 

1. Was not on a word 
boundary, or, 

2. Was greater than the 
highest address in the 
dump. 

• A job pack queue chain pointer 
or one of the fields in a job 
pack area control block could 
not be extracted from the dump 
because : 



1. IMDPRDMP encountered an 
I/O error attempting to 
read the block containing 
the needed data,, or, 

2. The block containing the 
needed data was missing 
from the dump; a possible 
cause is that the routine 
that produced the dump 
encountered an I/O error 
while attempting to write 
the block. 

Processing continues. 



ERROR IN LOAD LIST 



Explanation : The load list print 
routine encountered one of the 
following errors: 

• A pointer in the load list 
control block chain referenced 
an area of main storage that: 

1. Was not on a word 
boundary, or 

2. Was greater than the 
highest address in the 
dump. 

• A field in a load list queue 
control block could not be 
extracted from the dump 
because : 

1. IMDPRDMP encountered an 
I/O error attempting to 
read the block that 
contained the data needed 
to format the load list; 
or, 

2. The block containing the 
data was missing from the 
dump; a possible cause is 
that the routine that 
produced the dump 
encountered an I/O error 
while attempting to write 
the block. 



Processing continues. 

ERROR IN TCB CHAIN TCB aaaaaa 

Explanation : The routine that 
formats the TCBs encountered one 
of the errors given below; the 
address of the TCB associated with 
the error replaces the aaaaaa 
field of the output comment. 

• A TCB pointer for one of the 
TCBs in the TCB family chain 
addressed an area not on a 
word boundary; or. 
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• A TCB pointer or the TIOT 

pointer in the TCB at location 
aaaaaa points to an area that 
could not be extracted from 
the dump because: 

1. IMDPRDMP encountered an 
I/O error while attempting 
to read the block that 
contains the pointer; or, 

2. The routine that produced 
the dump encountered an 
I/O error while writing 
the block that contains 
the pointer; therefore, 
the block is missing from 
the dump. 



ERROR IN TIOT 



Explanation : The format routine 
found one of the following errors: 



The task input output table 
(TIOT) pointer (TCB + X^*) 
was not on a word boundary; 
or. 



ERROR WHILE FORMATTING PSCB 

Explanation : One of the following 
errors occurred while IMDPRDMP was 
formatting the protected step 
control block (PSCB) : 

• The address of the PSCB in the 
time sharing job block 
extension (TJBX) was greater 
than the highest main storage 
address in dump; or, 

• An I/O error occurred while 
reading the block of dump 
information that contained the 
needed data; or, 

• A block of dump information 
containing part of the PSCB 
was not found on either the 
dump or swap data sets. 

Processing continues. IMDPRDMP 
attempts to format the control 
blocks for the next TSO user. 

ERROR WHILE FORMATTING RCB 



• One of the fields required to 
format the TIOT could not be 
extracted from the dump 
because : 

1. IMDPRDMP encountered an 
I/O error while attempting 
to read the block that 
contains the required 
data, or, 

2. The block containing the 
required data was missing 
from the dump; a possible 
cause is that the routine 
that produced the dump 
encountered an I/O error 
while attempting to write 
the block. 

ERROR WHILE FORMATTING CONTROL BLOCKS 

CONTINUING 



Explanation : While building a 
list of job step TCB*s for all 
partition regions in the dump data 
set, PRDMP encountered one of the 
following conditions: 

1. One of the TCB chain pointers 
was greater than the highest 
address in the dump. 

2. One of the TCB chain pointers 
addressed an area that was 
missing from the dump data 
set. 

PRDMP will attempt to use the 
partial list and continue with its 
formatting. 



Explanation : One of the following 
errors occurred while IMDPRDMP was 
formatting the time sharing region 
control blocks (RCBs) : 

• The address of the RCB table 
in the time sharing 
communication vector table 
(TSCVT) was greater than the 
highest main storage address 
in the dump; or, 

• An I/O error occurred while 
reading the block of dump 
information that contained the 
needed data; or, 

• A block of dump information 
containing part of an RCB was 
not found on the dump data 
set. This happens when an I/O 
error occurred while the dump 
routine was writing the data 
onto the dump data set. 

Processing continues. IMDPRDMP 
attempts to format the next entry 
in the RCB table. 

ERROR WHILE FORMATTING SWAP CONTROL BLOCK 

Explanation : One of the following 
errors occurred while IMDPRDMP was 
formatting the swap control block 
(SWAP DCB) : 

• The address of the SWAP DCB in 
the time sharing communication 
vector table (TSCVT) was 
greater than the highest main 
storage address in the dump; 
or. 
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• An I/O error occurred while 
reading -the block of dump 
information that contained the 
data; or, 

• A block of dump information 
containing part of the SWAP 
DCB was not found on the dump 
data set. This happens when 
an I/O error occurred while 
the dump routine was writing 
the data onto the dump data 
set. 



• A block of dump information 
containing part of the TJB was 
not found on the dump data 
set. This happens when an I/O 
error occurred while the dump 
routine was writing the data 
onto the dump data set. 

Processing continues. IMDPRDMP 
attempts to format the next active 
TJB. 

ERROR WHILE FORMATTING TJBX 



Processing continues. IMDPRDMP 
attempts to continue formatting 
the time sharing job block (TJB). 

ERROR WHILE FORMATTING TAXE 

Explanation : One of the following 
errors occurred while IMDPRDMP was 
formatting the terminal attention 
exit element (TAXE) : 

• The address of the TAXE in the 
time sharing job block 
extension (TJBX) was not 
aligned in a fullword 
boundary ; or, 

• The address of the TAXE in the 
TJBX was greater than the 
highest main storage address 
in the dump; or, 

• An I/O error occurred while 
reading the block of dump 
information that contained the 
needed data; or, 

• A block of dump information 
containing part of the TJBX 
was not found on the dump or 
swap data sets. 

Processing continues. IMDPRDMP 
attempts to format the control 
blocks for the next TSO user. 

ERROR WHILE FORMATTING TJB 

Explanation : One of the following 
errors occurred while IMDPRDMP was 
formatting the time sharing job 
block (TJB) : 

• The address of the TJB table 
in the time sharing 
communication vector table 
(TSCVT) was greater than the 
highest main storage address 
in the dump; or,, 

• An I/O error occurred while 
reading the block of dump 
information that contained the 
needed data; or. 



Explanation ; One of the following 
errors occurred while formatting 
the time sharing job block 
extension (TJBX) : 

• The terminal job block (TJB), 
that contained the address of 
the TJB was not aligned on a 
fullword boundary; or., 

• The address of the TJBX in the 
TJB was greater than the 
highest address in the system 
dump; or, 

• An I/O error occurred while 
reading the block of dump 
information that contained the 
needed data; or, 

• A block of dump information 
containing part of the TJBX 
was not found on either the 
dump or swap data sets. 

Processing continues. IMDPRDMP 
attempts to format the control 
blocks associated with the next 
TSO user. 

ERROR WHILE FORMATTING TSB 

Explanation ; One of the following 
errors occurred while IMDPRDMP was 
formatting the terminal status 
block (TSB) ; 

• The address of the TSB table 
in the time sharing 
communication vector table 

(TSCVT) was greater than the 
highest main storage address 
in the dump; or, 

• An I/O error occurred while 
reading the block of dump 
information that contained the 
needed data; or, 

• A block of dump information 
containing part of the TSB was 
not found on the dump data 
set. This happens when a I/O 
error occurred while the dump 
routine was writing the data 
onto the dump data set. 
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Processing continues. IMDPRDMP 
attempts to format the associated 
time sharing job block extension 
(TJBX) . 



Processing continues. IMDPRDMP 
attempts to continue formatting 
with the terminal status block 
(TSB),. 



ERROR WHILE FORMATTING TSCVT 



FORMAT ERROR DURING TCB SUMMARY 



Explanation : One of the following 
errors occurred while IMDPRDMP was 
formatting the time sharing 
communication vector table 
(TSCVT) : 

• The address of the TSCVT in 
the communication vector table 

(CVT) was greater than the 
highest main storage address 
in the dump; or, 

• An I/O error occurred while 
reading the block of dump 
information that contained the 
needed data; or, 

• A block of the dump 
information containing part of 
the TSCVT was not found on the 
dump data set. This happens 
when a I/O error occurred 
while the dump routine was 
writing the data onto the dump 
data set. 

Processing continues. IMDPRDMP 
attempts to format the time 
sharing region control blocks 
(RCBs). 

ERROR WHILE FORMATTING USER MAIN STORAGE 
MAP 

Expla nat i on ; One of the following 
errors Occurred while IMDPRDMP was 
formatting the user main storage 
map (UMSM) : 

• The address of the UMSM 
associated with the region 
control task (RCT) or time 
sharing job block (TJB) was 
greater than the highest main 
storage address in the dump; 
or, 

• An I/O error occurred while 
reading the block of dump 
information that contained 
needed data; or, 

• A block of dump information 
containing part of the UMSM 
was not found in the dump data 
set. This happens when an I/O 
error occurred while the dump 
routine was writing the data 
onto the dump data set. 



Explanation : The routine that 
prints the TCB summary must 
extract a TCB completion code (TCB 
♦ X'W) or a TCB family chain 
pointer from the dump. In this 
case, IMDPRDMP was unable to do so 
because : 

• IMDPRDMP encountered an I/O 
error while attempting to read 
the block containing the 
completion code or pointer; 
or,, 

• The block containing the 
completion code or pointer was 
missing from the dump; a 
possible cause is that the 
routine that produced the dump 
encountered an I/O error while 
attempting to write the block. 

Processing for the current control 
statement is terminated. 

FORMAT ERROR IN MAIN STORAGE BLOCKS 

Explanation : While formatting 
main storage control blocks, 
IMDPRDMP encountered one of the 
following errors: 

• A pointer in a main storage 
control block addressed an 
area that: 

1. Was not on a word 
boundary; or, 

2. Was higher than the 
maximum address in the 
dump; or, 

• One of the fields in a main 
storage control block could 
not be extracted from the dump 
because : 

1. IMDPRDMP encountered an 
I/O error while attempting 
to read the block that 
contains the required 
field; or, 

2. The block containing the 
required field is missing 
from the dump; a possible 
cause is that the routine 
that produced the dump 
encountered an I/O error 
while attempting to write 
the block. 

Processing continues. 
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INFINITE LOOP IN DEB CHAIN 



NO EXTENT LIST 



Explanation s While formatting the 
data extent blocks (DEBs) , 
IMDPRDMP found more than 200 DEBs 
chained to the TCB. The limit of 
200 DEBs prevents IMDPRDMP from 
looping- When the limit is 
exceeded, a loop is assumed which 
causes this comment to be printed.. 
Processing continues after the 
first 200 DEBs are printed. 



Explanation ; While formatting the 
load list and job pack queue for 
an MVT dump, IMDPRDMP encountered 
zeros in the extent list pointer 
(CDE + '20*) in a major contents 
directory entry (CDE) . This zero 
pointer usually indicates an error 
condition in which the extent list 
pointer was overlaid with zeros. 
Processing continues with the next 
CDE. 



INFINITE LOOP IN PQES 



Explanation s The main storage 
print routine found more than 50 
partition queue elements (PQEs) 
chained to the TCB. A limit of 50 
PQEs has been established by 
IMDPRDMP to prevent a possible 
looping condition. When the limit 
is exceeded, a loop is assumed and 
this comment is issued. The first 
50 PQEs are printed and then 
processing continues. 



INFINITE LOOP IN RB CHAIN 



Explanation s The RB print routine 
found more than 50 request blocks 
(RBs) on the RB chain. A limit of 
50 RBs has been established within 
IMDPRDMP to prevent a possible 
looping condition. When the limit 
is exceeded, a loop is assumed and 
this comment is issued. The first 
50 RBs are printed and then 
processing continues. 



INVALID TIOT 



Explanation s While formatting the 
task input output table (TIOT), 
the FORMAT routine found an 
invalid job name in the TIOT. To 
be valid, the first character of 
the job name must be A through Z, 
or $, #,, a or a blank (x*40*). 
Processing continues. 



NO ELEMENTS ON LOAD LIST 



Explanation s The load list 
pointer in the TCB (displacement 
X^iJ") is zero. The zero pointer 
indicates that (1) no programs 
were loaded by the LOAD macro 
instruction or (2) the load list 
pointer was overlaid with zero. 
Processing continues. 



NO LINK PACK AREA QUEUE 



Explanation s In MFT, an LPAMAP 
was requested but the link pack 
area queue pointer (CVT + X'BC*) 
was zero. Processing continues. 



NO MAJOR QCBS 



Explanation s The QCB TRACE 
routine found zeros as the pointer 
to the first major queue control 
block (QCB) . This indicates that 
no resources have been enqueued at 
the time of the dump or that the 
pointer to the QCB queue has been 
overlaid with zeros. Processing 
continues. 



NOTHING IN JOB PACK 



Explanation s In MVT, the job pack 
queue field of the TCB (TCB + 
X^C*) is zero. In MFT, the 
partition information block (PIB) 
field (TCB + X^C*) or the job 
pack queue pointer (PIB + X'24*) 
is zero. PCP does not have a job 
pack pointer; therefore, this 
comment does not appear in a PCP 
dump. A zero job pack queue 
pointer is usually a normal 
condition, especially for a system 
task. Processing continues. 



RB FORMAT ERROR 



Explanation s While formatting a 
request block (RB) , the RB print 
routine found that the request 
block (RB) chain pointer addressed 
an area of main storage thats 

• Was not on a word boundary; 
or, 

• Was higher than the highest 
address in main storage; or, 

• Could not be extracted from 
the dump because s 
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1. IMDPRDMP encountered a I/O 
error while attempting to 
read the block that 
contained the pointer; or, 

2. The block that contained 
the pointer was missing 
from the dump. One 
possible cause for this is 
that the program that 
produced the dump may have 
encountered an I/O error 
while writing the block. 

• A field in the RB,, or a 

contents directory entry (CDE) 
associated with the RB, 
necessary to formatting the RB 
could not be extracted from 
the dump. Either IMDPRDMP 
encountered an I/O error while 
trying to read the block , or 
the block that contained the 
pointer is missing from the 
dump. 

REGISTERS PROM OTHER CPU ARE INVALID- NOT 
FORMATTED 

Explanation ; Multiprocessing 
systems only. Only the registers 
for the CPU in which the dump 
program was executed will be 
displayed on the dump listing. 
This can occur when the dump is 
taken on a multiprocessing system 
either when the NOMP option of 
IMDSADMP is used or when the 
direct control feature is not 
operational. 

TASK HAS NO OPEN DATA SETS 

Explanation ; IMDPRDMP found the 
data extent block (DEB) pointer in 
the TCB (TCB + X* 8') to be zero. 
This situation indicates that 
there were actually no open data 
sets or the DEB pointer in the TCB 
was overlaid with zeros. 
Processing continues. 

TASK HAS NO TIOT 

Explanation ; While attempting to 
format the task input output table 
(TIOT),, IMDPRDMP found that the 



TIOT pointer (TCB ♦ T^') was 
either zero or larger than the 
highest address in the dump. The 
zero TIOT pointer could be a 
normal condition for a system 
communication task, but for a 
problem program task this is an 
error condition. Processing 
continutes. 

TASK HAS TERMINATED 

Explanation ; After formatting a 
TCB, this comment is printed below 
the TCB if the first bit (the 
terminated bit) of the flag byte 
at x*21" of the TCB is set. 
Processing continues with the next 
TCB. 

TCB CHAIN ERROR IN F03 PRINT ROUTINE 
TCB aaaaaa... CONTINUING WITH NEXT TCB 

Explanation ; The Print F03 
routine encountered a TCB chain 
pointer that; 

• Was not on a word boundary; 
or, 

• Addressed an area that could 
not be extracted from the dump 
because : 

1. The pointer addressed an 
area higher than the 
maximum address in the 
dump; or, 

2. IMDPRDMP encountered an 
I/O error trying to read 
the record containing the 
area addressed by the 
pointer; or, 

3. The block containing the 
addressed area was missing 
from the dump, probably 
because the routine that 
produced the dump 
encountered an I/O error 
while attempting to write 
the block. 

The address of the TCB associated 
with the error replaces the aaaaaa 
field in the message. Processing 
continues with the next TCB. 
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GUIDE TO STORAGE DUMPS 



The purpose of this section is to suggest 
debugging procedures that you may use with 
a storage dump. This discussion applies to 
the output of the following programs: 

• IMDSADMP- The low speed version that 
formats and dumps main storage. 

• IMDPRDMP- Reads, formats, and prints 
storage dumps from MPT or MVT systems 
and the high speed version of IMDSADMP. 

These programs produce hexadecimal dumps of 
the contents of main storage from location 
zero to the highest machine address. 

The IMDPRDMP program provides formatting 
capabilities which can be used to display 
the important system control blocks for 
easy examination. The IMDPRDMP program 
does most of the procedures described in 
this section automatically. The cases in 
which the IMDPRDMP program does not provide 
formatting are identified. A complete 
description of the services provided by the 
IMDPRDMP program is found in the 
publication, IBM System/360 Operating 
System: Service Aids , GC28-6719. 

Since the formatting for the IMDPRDMP 
program depends on the contents of the 
dump, it is not always possible to provide 
complete formatting. For example, if the 
CVT of the system to be dumped has been 
overlaid, the IMDPRDMP program can provide 
only a hexadecimal dump of main storage. 
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DETERMINING THE CAUSE OF THE DUMP 

Main storage dumps are invoke by system 
routines and these routines can be 
identified by module names appearing in the 
most recent request block (RB) for the 
failing task. The main storage dump is 
invoked by SVC 51. This SVC PSW appears as 
the resume PSW in the second most recent RB 
of some task in the system. The module 
name in the current RB for that task must 
be 20 1C. 

Main storage locations from zero to 128 
(hexadecimal 80) are permanently assigned 
and contain hardware control words. Figure 
28 shows these fields, their location, 
their length,, and their purpose. 



| Address j Length j 
Dec Hex j In Bytes j 



Purpose 



j. + 

1 j 8 
,. i 

j 8 8 j 8 

1 16 10 | 8 

.24 18 | 8 

1 32 20 | 8 

1 40 28 | 8 

h "I 

1 48 30 j 8 

| 56 38 | 8 

| 64 40 | 8 

|72 48 | 4 

| 76 4C | 4 

| 80 50 | 4 
j. ^ 

| 84 54 j 4 

| 88 58 | 8 

I- i 

| 96 60 j 8 

|104 68 | 8 
| 112 70 | 8 



|IPL PSW 
|IPL CCW1 
|IPL CCW2 



1 



j External old PSW j 

| Supervisor call old PSW j 

j Program old PSW j 

j Machine check old PSW | 

| I/O old PSW | 

j Channel Status Word | 

j Channel Address Word j 

j Unused j 

j Timer | 

j Unused j 

(External new PSW j 

(Supervisor call new PSW | 

| Program new PSW j 

j Machine check new PSW | 
j. + + _. ^ 

120 78 j 8 (I/O new PSW j 

Figure 28. Permanently Assigned Hardware 
Control Words 

Cause of the Dump : Evaluate the PSWs that 
appear in the formatted section of the dump 
(the first four lines) to find the cause of 



the dump. The PSW has the following 
format: 



Program Status Word 



System Mask 


Key 


AMWP 


Interruption Code 



7 8 11 12 15 16 



31 



ILC 


CC 


Program 
Mask 


Instruction Address 



32 33 34 35 36 



39 40 



63 



Does the instruction address field of 
the old machine check PSW show either 
the value E2 or E02? If so, a hardware 
error has occurred. 

Does the instruction address field of 
the old program check PSW have a value 
other than zero? If so, a program 
check at the instruction preceding that 
address caused the interruption. 



TASK STRUCTURE 

MFT System (Without Subtaskinq) 

There is a TCB associated with each 
partition of main storage there are also 
TCBs for critical system tasks such as the 
master scheduler task and the transient 
area loading task. Figure 28 shows 
location 76 (4C) unused for hardware 
control words. The control program uses 
this word to contain a pointer to the CVT. 
Use this CVT pointer to locate the first 
byte of the CVT, then the CVTIXAVL field 
(offset 124) in the CVT. The address 
contained at CVTIXAVL is a pointer to the 
IOS freelist. At offset 4 in the IOS 
freelist is a pointer to the first address 
in a list of TCB addresses. You can look 
through this list of TCB addresses, and, 
keeping your system options in mind, find 
the TCBs for each partition. The TCB 
addresses are listed in the following 
order: 

• Transient area loading task. 

• System error task (MFT with 
subtasking) . 

• Multiple console support write-to-log 
task (optional). 

• I/O recovery management support task 
(optional). 

• Communications task. 

• Master scheduler task. 

• System management facilities task 
(optional) . 

• Partition task. 
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• Partition 1 task. 



MVT System 



• Partition n task. 

Figure 29 shows how to locate the 
partition TCBs in sample output from the 
IMDPRDMP program. 

MFT System (With Subtasking) 

For MFT with subtasking (and for MVT),, a 
task may create a subtask. The partition 
TCBs for MFT with subtasking are referred 
to as job step TCBs . The task structure 
for a job step may be reconstructed in a 
main storage dump by using the information 
in Figure 32. 

For MFT with subtasking, the job step 
TCB may be found using the method described 
for MFT without subtasking or by a more 
direct method. CVT offset 245 (F5) 
contains a pointer to the partition job 
step TCB address in this address table. 

To recreate the task structure within 
any partition, simply locate the job step 
TCB, and follow the TCB pointers - as 
explained in the previous section. 



To find the current TCB, look aL location 
76 (4C) for a pointer to the CVT. The 
first word of the CVT contains a pointer to 
a double word of TCB addresses, which 
contains pointers to the next TCB to be 
dispatched (first word) and the current TCB 
(second word). Beginning with the current 
TCB, you can recreate the task structure 
for the job step using the methods in 
Figure 32. 

If the first word of the current TCB 
points to itself, there are no ready tasks 
to be dispatched, and the system has been 
placed in ah enabled wait state. This TCB, 
now in control, is called the system wait 
TCB . 

All TCBs in the system are maintained in 
a queue called the CVT ready queue. These 
TCBs are queued according to their 
dispatching priority. The CVTHEAD field, 
offset +160 (A0) in the CVT, contains the 
address of the highest priority TCB in the 
system. Offset +116 (74) in the TCB points 
to the TCB with the next lowest priority. 
Figure 30 shows how to locate all of the 
TCBs in the system. 



Location 4C 




008D40 00000000 00000000 0007D2D8 hhhhhhhh 

00 8D60 hhhhhhhh hhhhhhhh hhl^^^^^^W 

008D80 hhhhhhhh hhhhhhhh hhl^^^^^^^^^p 

00 8DA0 hhhhhhhh 



hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 



Figure 29. Finding the Partition TCBs in MFT 
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Job Step TCB 




(A) is a job step TCB and (IT) is the | (M is a job step TCB. HM is the TCB for the first 
TCB of the subtask created by (a) | subtask created by (a) . (&z) is the TCB for the 

Offset +136(88) in (a) points to its second and most recent subtask created by \AJ . 

subtask TCB ( (?) ). Offset +132(84) I Offset +136(88) in (a) points to the TCB of its 
in the subtask TCB ( (b) ) points back J most recently created subtask. Offset +136(84) 
to the job step TCB ( (a) ). I in (^points back to the creating task ( (a) ). 

' Offset +128(80) in ([£) points to (bJ) the next 
most recently created subtask TCB. Offset 
+ 132(84) in (Bi) points back to the originating 
TCB ( ). 



In each TCB: 
Offset 

+ 128(80) points to the TCB of the next most 
recently created subtask. If none 
exists, this field is zero. 

+ 132(84) points to the TCB of the task that 

created it. If none exists, this field 
is zero. 

+ 136(88) points to the TCB of the most recent 
subtask created by this task. If none 
exists, this field is zero. 





TCB 


+128(80) 


00 


+ 132(84) 


.00 







©Subtask 
TCB 




(a) is the job step TCB. (b7) is the TCB for the first subtask created by (a) . (B^)is the TCB 
for the second and most recent subtask created by ( A) . Offset + 136(88) in ( A) points to 
the TCB of its most recently created subtask. Offset + 132(84) in (B^ points to the TCB of the 
creating task. Offset +128 in (Bg) points to the next most recently created subtask TCB. 
Offset +132(84) in (1£)points back to the job step TCB ( (a) ). Offset +136(88) in (j£) 
points to the TCB of its most recently created subtask ( (C J ). 

(Cjj points to the TCB of its creating task ( (by) and to the TCB of the subtask most 
recently created by (B2) . (C2) contains pointers to the TCB of the originating task ( HJj) ) 
and to the TCB of the task most recently created by (B2) . (C2) contains only a pointer to 
the TCB of the invoking task ( (j£)). 



Figure 30. Finding the TCB 



Keep in mind that all TCBs in the system 
appear on this queue. Therefore,, not only 
does a particular job step TCB appear on 
the ready queue,, but all of its subtask 
TCBs also appear - 

You can find the job step TCB associated 
with any TCB by using the TCBJSTCB field of 
the TCB, offset +124 (7C). This field 
contains the address of the job step TCB 
for the TCB you are examining. 

In response to the FORMAT control 
statement, the IMDPRDMP program will do 
most of this work for you. It will 
recreate the task structure, format all 
TCBs in the system,, and provide a TCB 
summary. The TCB summary shows the task 
structure. Figure 31 shows a portion of 
the TCB summary information from an MVT 
system. TCBs associated with a particular 
job are grouped together under the job name 
and step name. The TCB summary contains 
the TCB address, the completion code, and, 
when applicable, the address of the 
originating TCB and the addresses of 
created TCBs. 



and/or second words of the RB for its 
EBCDIC name or in the last 3 digits of the 
resume PSW in the previous RB for its SVC 
number. The entry point to the module is 
in the last 3 bytes of the fourth word in 
the RB, RB-13CD). 

In an MVT system, the name and entry 
point of the associated load module are not 
always contained in the RB associated with 
the module. Instead, they are found in a 
contents directory entry (CDE). 

The address of the contents directory 
entry for a particular load module is given 
in the fourth word of the RB, RB+12CO. 
The CDE gives the address of the next entry 
in the directory (bytes 1-3) , the name of 
the load module, bytes 8-15 (F); the entry 
points of the module, bytes 17-19(11-13). 

Figure 32 shows the formatting that the 
IMDPRDMP program does for a task in an MVT 
system. Notice the connection between the 
RB and the CDE. The IMDPRDMP program 
extracts the CDE information and displays 
this information with the RB. 



TASK STATUS - ACTIVE RB QUEUE 

The first word of the TCB contains a 
one-word pointer to the first word of the 
most recent RB added to the queue. In its 
eighth word, RB+28(1C) 1 , each RB contains a 
pointer to the next most recent RB. The 
last RB points back to the TCB. 

You can determine the idenity of the 
load module by looking either in the first 



The wait-count field of the RB is 
particularly important when locating the 
TCB by using the CVT ready queue (CVTHEAD) . 
The high-order byte of the RB link field, 
RB-28(1C), of the most recent RB for a TCB 
contains a count of the number of events 
for which the task is waiting. Tasks that 
have a zero wait count are ready to be 
dispatched (unless marked 
non-dispatchable). Such a task will be 
dispatched or become the current task when 
all TCBs of higher priority are waiting for 
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Figure 31. IMDPRDMP TCB Summary 
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the completion of an event. To determine 
the events for which a task is waiting, use 
the instruction address field in the resume 
PSW to locate the WAIT macro instruction in 
the source program. This will point you to 
the operation being executed at the time of 
the dump. 



MAIN STORAGE CONTENTS 

Load List (MFT) 

The load list is a chain of request blocks 
associated with load modules invoked by a 
LOAD macro instruction. By looking at the 
load list,, and at the job pack area queue 
described below., you can determine which 
system and problem program routines were 
loaded before the dump was taken. To 
construct the load list associated with the 
task in control, look at the tenth word in 
the TCB,, TCB* 36 (24), for a pointer to the 
most recent RB entry on the load list, 
minus 8 bytes (RB-8). This word, in turn, 
points to the next most recent entry (minus 
8),, and so on. If this is the last RB, 
RB-8 will contain zeroes. The word 
preceding the most recent RB on the list 
(RB-4) points back to the TCB's load list 
pointer. 

Load List (MVT) 

To construct the load list associated with 
the task in control, look at the tenth word 
in the TCB, TCB+36(24), for a pointer to 
the most recent load list entry (LLE). 
Each LLE contains the address of the next 
most recent entry (bytes 0-3), the count 
(byte 4), and the address of the' CDE for 
the associated load module (bytes 5-7). If 



this is the last LLE in the list., 
TCB+36(24) will contain zeroes. 

Job Pack Area Queue (MFT With Subt asking, 
MVT) 

In systems with MFT with subtasking or MVT 
control programs,, the job pack area queue 
is used to maintain reenterable modules 
within a partition or region. The complete 
description of this queue is found under 
the topic "Task Status-Active RB Queue". 

MFT System ; To reconstruct the job pack 
area queue in an MFT system with 
subtasking, look at TCB+125C7D) for a three 
byte pointer to the partition information 
block (PIB). The twelfth word of the PIB,, 
PIB+44 (2C) , points to the most recent RB on 
the job pack area queue minus 8 bytes 
(RB-8). This word in turn points to the 
next most recent RB minus 8, and so on. 
The last RB will have zero in this field. 
The word preceding the most recent RB on 
the queue (RB-4) points back to the job 
pack area queue pointer in the PIB. You 
can determine the identity of the load 
module by looking either in the first 
and/or second word of the RB for its EBCDIC 
name, or in the last three digits of the 
resume PSW in the previous RB for the SVC 
number. The entry point of the module is 
given in the last three bytes of the fourth 
word in the RB, RB+29 (ID) , unless it is an 
FRB. 

The first five words of an FRB 
(beginning at offset minus 8) are identical 
in content to those of other RBs- The 
XRWTL field, offset 12(C), contains the 
address of a wait list element. The first 
word of the WLE points to the next WLE, or 
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Entry Point Address 



Figure 32. Determining Module From CDE in MVT 
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contains zeros if the WLE is the last one. 
The second word points to the waiting SVRB. 
You can determine the number of deferred 
requests for the module by tracing the 
chain of WLEs. 

The XRREQ field of an FRB<, offset 
16 ( 10 ) , contains a pointer to the TCB of 
the requesting task. The next word, 
CRTLPRB,, offset 20 (14), points to an LPRB 
built by the Finch routine for the 
requested program. The FRB for the 
requested program is removed from the job 
pack area queue by the Finch routine when 
the program is fully loaded,. 

MVT System ; In MVT, the job pack area 
queue is maintained in the same manner as 
the load list. The distinction between the 
two queues is that the job pack area queue 
contains reenterable programs. There are 
no FRBs in MVT. 



MAIN STORAGE SUPERVISION 

Free Areas in MFT Systems 

Areas of main storage that are available 
for allocation at the time the dump was 
taken are described by the MSS boundary box 
and a series of free queue elements (FQEs). 
The seventh word of the TCB for the task, 
TCB+24(18), points to a six- word MSS 
boundary box. The first word of the MSS 
boundary box points to the FOE with the 
highest processor storage address in the 
partition (hierarchy 0), and the fourth 
word,, to the highest 2361 Core Storage 
address in the partition (hierarchy 1). 
The first word of each FQE points to the 
next lower FQE; the second word of the FQE 
gives the length of the area it describes. 
FQEs occupy the first 8 bytes of the area 
they describe. 

Gotten Subtask Areas (MFT) 



In MFT with subtasking, areas of a 
partition allocated by the system to a 
subtask within the partition are described 
by gotten subtask area queue elements 
(GQEs). The seventh word of the subtask 
TCB, TCB+24(18),, points to a one word 
pointer to the most recently created GQE on 
the GQE queue. Bytes through 3 of the 
GQE contain a pointer to the previous GQE 
or,, if zero, indicate that the GQE is the 
last one on the queue. Bytes 4 through 7 
of the GQE contain the length of the gotten 
subtask area. Each GQE occupies the first 
eight bytes of the gotten subtask area it 
describes. 

Region Structure in MVT System 

The region associated with a particular 
task in an MVT system is described by 



partition queue elements (PQEs). The 
thirty-ninth word of the TCB, offset +152 
(98) contains a pointer to the dummy PQE 
(D-PQE) for the region. The first word of 
the dummy PQE points to the first PQE and 
the second word,, to the last PQE. The 
first and second words of each PQE point to 
the first and last free block queue 
elements (FBQEs), respectively, associated 
with the PQE. Separate PQEs are used to 
describe parts of a region in different 
storage hierarchies or part of a region 
that was obtained by another task which has 
been rolled out. 

FBQEs describe free areas in the region 
that have a a length which is a multiple of 
2048 bytes. These free areas are available 
for allocation to a specific subpool. 

Subpool Descriptions (SPQEs) (MVT) : The 
seventh word of the TCB, TCB+24(18), points 
to the SPQE representing the first subpool 
used by the task. Each SPQE contains the 
address of the next SPQE (bytes 1-3), the 
subpool number (byte 4), and the address of 
the first descriptor queue element (DQE) 
for the subpool (bytes 5-7) or, if the 
subpool is owned by another task (bit is 
1) , the address of the SPQE that describes 
it (bytes 5-7). 

Storage within a subpool is described by 
a descriptor queue element. Each DQE 
contains the number of bytes of main 
storage in the subpool. This count is 
always a multiple of 2048 bytes. If a 
request for space from a subpool cannot be 
satisfied with the space described by an 
existing DQE the GETMAIN routine builds 
another DQE and links the new DQE to the 
chain of existing DQE» s. Each DQE contains 
a pointer to the FQE that represents the 
free area with the highest main storage 
address in the subpool (bytes 1-3) , a 
pointer to the next DQE (bytes 5-7) , and 
the length of the area described by the 
DQE, bytes 13-15 (D-F). 

Figure 33 shows the control blocks used 
to describe the subpools for a task in an 
MVT system. 



I/O CONTROL BLOCKS 

Queue of DEBs 

To find the queue of DEBs for the task,, 
look at the third word in the TCB (TCB+8). 
The address given here points to the first 
word of the most recent entry on the DEB 
queue. There is a DEB on this queue for 
each data set opened to the task at the 
time of the dump. DEBs are enqueued in the 
same order as the data sets are opened. 
The last three bytes of the second word in 
each DEB (DEB+5) points to the next most 
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recent. DEB on the queue. The queue 
contains one DEB for each open data set. 

UCBs 

You can find unit information for each 
device in your system in the unit control 
block (OCB) for that device. The address 
of the UCB is contained in the last 3 bytes 
of the ninth word of the DEB, DEB+33(21). 
If the DEB queue is empty, scan the dump 
around location 4096(1000) for words whose 
fifth and sixth digits are FF. These are 
the first words of the UCBs for the system; 
UCBs are arranged in numerical order by 
device address.. (You may find it easier to 
locate UCBs by looking for the device 
address in the EBCDIC printout to the right 
of each page.) The first two bytes of the 
second word of each UCB give the device 
address. The device type and class are 
given in the third and fourth bytes of the 
fifth word,, UCB+18(12), respectively. The 
sense bytes, with the exception of those 
for devices with extended sense, begin in 
the last two bytes of the sixth UCB word, 
UCB+22(16), and continue from 1 to 6 bytes 
depending on the device type. For the 
extended sense devices, UCB+22 and UCB+23 
are ignored. UCB* 24 (18) in this case 
contains the number of bytes of sense 



information to be found starting at the 
address specified in UCB+25(19)« Sense 
bytes are given in Appendix G of this 
publication. 

DCB and TIOT 

The address of the DCB, a control block 
that describes the attributes of an open 
data set, is located in the last 3 bytes of 
the seventh DEB word, DEB+25(19). The 
first two bytes of the ninth word of the 
DCB, offset 40(28), contains the offset in 
the task input/output table (TIOT) of the 
DD name entered for the data set. 
Therefore,, the address of the DD name for a 
particular data set may be found by adding 
the TIOT offset in the DCB to the TIOT 
address in the TCB (TCB+12) , plus 24(16) 
bytes for the TIOT header. 

IOB 

If a data set is being accessed by a 
sequential access method with normal 
scheduling, the address of the input/output 
block (IOB) prefix (IOB-8) is located in 
the seventeenth word of the DCB, 
DCB-68(44). The first word of the IOB 
prefix points to the next IOB (if more than 
one IOB exits for the data set) . Each IOB 



Address of 
SPQE for 
Subpool 




FQE describing 1896(768) 
bytes of free storage 

Figure 33.. Subpool Descriptions in MVT - IMDPRDMP Storage Print 



144 Programmer's Guide to Debugging (Release 21) 



UCB 



UCBID 
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011E20 
011E40 
011E60 
011E80 
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021320 
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hhhhhhhh hhhhhhhh 
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DDNAME 



TIOT (g 
Offset 



2133C 



Figure 34. I/O Control Blocks 



for an open data set contains a pointer to 
the CCW list in the last three bytes of the 
fifth word, IOB+17C11). 



ECB 



The Completion code for an I/O operation is 
posted in the first byte of the event 
control block (ECB). ECB completion codes 
are explained in Appendix F. If the I/O 
event is not complete and an SVC I (WAIT) 
has been issued, the high- order bit of the 
ECB is on, and bytes one through three 
contain the address of the associated RB. 
For the sequential and basic partition 
access methods the second word of an I OB 
points to its associated ECB. 



Figure 34 shows the DEB, UCB, DCB, and 
IOB for a BSAM data set. 



TSO CONTROL BLOCKS 

The time sharing (TSO) control blocks are 
obtained from the IMDPRDMP service aid 
program by specifying the TSO control 
statement in the input stream. The first 
part of the TSO dump is the same as the 
normal MVT dump. The control blocks that 
IMDPRDMP formats are divided into two 
group: system and user. 



TSCVT 

The time sharing communications vector 
table (TSCVT) is a secondary CVT for the 
MVT CVT. The time sharing CVT resides in 
the time sharing region; therefore, it 
exists only while the time sharing region 
is active. When time sharing does not 
exist in the system, the MVT CVT pointer to 
the TSCVT (CVT+229) is zero. 
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RCB 



A region control block (RCB) contains 
information that is unique to a time 
sharing region. There is one RCB for each 
time sharing region. The RCBs reside in 
the time sharing controller's region, they 
are contiguous, and they are created during 
initialization of the time sharing 
controller. 

The TSCVT points to a region control 
block table. The RCB table is an indexed 
table containing one RCB address for each 
possible time sharing region, therefore, 
the table contains the maximum number of 
RCBs that may be used by time sharing. The 
first RCB is for region one, the second for 
region two, etc. The time sharing job 
block (TJB) of a job points to the RCB 
associated with that job. 

UMSM 

One user main storage map (UMSM) exists for 
each possible time sharing user. The UMSM 
contains a series of consecutive one-word 
extent fields (ADDR-LN). Each one-word 
extent contains a halfword address field 
(ADDR) and a halfword length field (LN) 
that describes the main storage allocated 
to the time sharing user. The UMSM 
contains the address and length of a 
storage block (a multiple of 2K bytes) that 
has been allocated to the user; only this 
allocated storage will be swapped out for 
the user. The time sharing job block (TJB) 
points to the UMSM. 

SWAP DCB 

The swap data control block (SWAP DCB) is 
used whenever a time sharing user's region 
is swapped into or out of main storage. It 
describes a swap data set that contains an 
IOB, area for channel programs, and the 
track map queue. The TJB points to the 
swap DCB. 

TJB 

The time sharing job block (TJB) contains 
status information about a time sharing 
user. The TJB is retained in main storage 
while the user is swapped out. One time 
sharing job block exists for each possible 
simultaneous time sharing user. The space 
for the TJB is obtained from the time 
sharing control task (TSC) region during 
time sharing initialization. Status 
information about the terminal related to 
this TJB is contained in the terminal 



status block (TSB). The address of the 
terminal status block is the first word of 
the TJB. The first word of the TSCVT 
points to the TJB. 

TSB 

Each terminal status block (TSB) contains 
status information about one terminal. The 
terminal input/output coordinator (TIOC) 
uses this information. During system 
initialization, one TSB is created for each 
possible user. The main storage space is 
obtained in one contiguous block for all of 
the TSBs in the region of the time sharing 
control task (TSC) ; this contiguous string 
of TSBs is called the TSB table. The 
origin pointer to the TSB table is the 
TIOCTSB field of the TIOCRPT. 

TJBX 

The time sharing job block extension (TJBX) 
contains user job information that can be 
rolled out to the swap data set with the 
user's job. The TJBX resides in the local 
system queue space (LSQS) for the region. 
The TJBX location is pointed to by the 
third word of the time sharing job block 
(TJB). The space for the TJBX is obtained 
by the region control task (RCT) during 
initialization. 

PSCB 

The protected step control block (PSCB) 
contains accounting information related to 
a single user. All timing information is 
in software timer units. A software timer 
unit is equal to 26.04166 micro seconds. 
The job step control block ( JSCB) , offset 
268, points to the PSCB. 

TAXE 

The TSO terminal attention exit element 
(TAXE) is a physical addendum to a regular 
24 word interrupt request block (IRB). It 
is used to schedule an attention exit 
resulting from a terminal attention 
interruption. It is created, queued, and 
dequeued by the specify terminal attention 
exit (STAX) macro instruction. The main 
storage space for the TAXE is obtained in 
the local system queue space (LSQS) of the 
terminal user's region. 

For a more detailed description of the 
TSO control blocks formatted by the 
IMDPRDMP program, see the Control Block 
and/or TSO Control Program PLM 
publications . 
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Section 3: Tracing Aids 



Tracing aids available are the save area 
chain, trace option, and Generalized Trace 
Facility (GTF) . This section provides a 
description of each tracing aid, and, for 
GTF, describes its output after processing 
by the IMDPRDMP service aid. 



Save Area Chajn 

The save area chain is edited and clearly 
identified in ABEND/ SNAP dumps, and can be 
located easily in storage dumps produced by 
system dump facilities or the IMDSADMP 
service aid. 

A save area is a block of 72 bytes 
containing chain pointers and register 
contents. It has the following format: 



1. Save registers 0-12 in bytes 

20-71 (14-3F) of save area 1 when it is 
entered. 



2. Establish a new save area (save area 
2). 

3. Place the contents of register 13 into 
bytes 4-7 of save area 2. 

4. Place the address of save area 2 into 
register 13. 

5. Place the address of save area 2 into 
bytes 8-11 (B) of save area 1. 

At this point, the save areas appear as 
shown in Figure 35. 



f Next higher save area 



f Next lower i 



.RegfcterWl 



12(C) 



Register 151 



Content* of / ) register* 0-12 



16(10) 20(14) 

Bytes 4-7: Pointer to the next higher 

level save area or, if this is 
the highest level save area, 
zeros. 

Bytes 8-11 (B): Pointer to the next lower 
level save area or, if this is 
the lowest level save area, 
unused . 

Bytes 12-15 (C-F) : Contents of register 14 
(optional) 

Bytes 16-19(10-13): Contents of register 
15 (optional) 

Bytes 20-71 (14-3F) : Contents of registers 
to 12 

The save area for the first or highest 
level load module in a task (save area 1) 
is provided by the control program. The 
address of this area is contained in 
register 13 when the load module is first 
entered. It is the responsibility of the 
highest level module to: 





Save area 1 






+ 4 


0000 


+8 


Save area 2 






+ 20(14) 


Contents of 
registers 0-12 



Save area 2 



+4 



+68(44)' 



Save area 1 



Register 13 



Save area 2 



Figure 35. Save Area Trace 

If a module requests a lower level 
module, it must perform actions 1 through 4 
to ensure proper restoration of registers 
when it regains control. (Action 5 is not 
required, but must be performed if the dump 
printout of the field is desired.) A 
module that does not request a lower level 
module need only perform the first action. 

ABEND and SNAP dumps include edited 
information from all save areas associated 
with the dumped task under the heading 
"SAVE AREA TRACE". In a stand-alone dump, 
the highest level save area can be located 
through a field of the TCB. Subsequent 
save areas can be located through the save 
area chain. 
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TRACE OPTION 

The tracing routine is an optional feature 
specified during system generation.. This 
routine places entries, each of which is 
associated with a certain type of event, 
into a trace table. When the table is 
filled, the routine overlays old entries 
with new entries, beginning at the top of 
the table (the entry having the lowest 
storage address). The contents and size of 
a trace table are highly system-dependent. 

Systems With MFT : Trace table entries for 
systems with MFT are 4 words long and 
represent SIO, I/O, SVC and dispatcher 
task- switching interruptions. Figure 36 
shows the word contents of each type of 
entry. 



j Current Entry j First Entry | Last Entry | 

4 8 

You can locate the trace table by scanning 
the contents of main storage between 
locations 16,384(4000) and 32,768(8000) for 
trace table entries. Entries are four 
words long and begin at addresses ending 
with zero. To find the table boundaries 
and current entry, scan the table in 
reverse until you reach the trace table 
control block. 

Trace Table Entries in MFT : Trace table 
entries for systems with MFT are 4 words 
long and represent occurrences of SIO, I/O, 
SVC, and task-switching interruptions. 
Figure 39 gives some sample entries and 
their contents. 



SIO 


CC/Dev 


CAW 


CSW 







1 


2 


I/O 


I/O OLD PSW 


CSW 









2 


SVC 


SVC OLD PSW 


Reg 


Reg 1 









2 3 


Task 
Switch 


PSW 


t New TCB 


| Old TCB 



Figure 36. Trace Table Entries (MFT) 

S ystems with MVT : The trace table in a 
system with MVT is expanded to include more 
entries and more information in each entry. 
Trace table printouts occur only on SNAP 
dumps and stand-alone dumps,. Entries are 
eight words long and represent occurences 
of SIO, external, SVC, program, and I/O 
interruptions, and dispatcher loaded PSWs. 

Figure 37 shows the word contents of 
trace table entries for SNAP dumps and 
stand-alone dumps. Figure 38 shows the 
contents of trace table entries as filled 
by MVT with Model 65 multiprocessing. (SSM 
— set system mask — entries are 
optional.) 



INTERPRETING TRACE TABLE ENTRIES 

Location 84(54) in main storage contains 
the address of the first word of the three 
word trace table control block. The trace 
table control block immediately preceeds 
the table. The trace table control block 
describes the bounds of the table and the 
most recent entry at the time of the dump. 



SIO entries can be used to locate the CCW 
(through the CAW) , which reflects the 
operation initiated by an SIO instruction. 
If the SIO operation was not successful, 
the CSW STATUS portion of the entry will 
show you why it failed. 

I/O entries reflect the I/O old PSW and the 
CSW that was stored when the interruption 
occurred. From the PSW, you can learn the 
address of the device on which the 
interruption occurred (bytes 2 and 3), the 
CPU state at the time of interruption (bit 
15) , and the instruction address where the 
interruption occurred (bytes 5-8). The CSW 
provides you with the unit status (byte 4), 
the channel status (byte 5) , and the 
address of the previous CCW plus 8 (bytes 
0-3). 



SVC 
External 
Program 


PSW 


Reg 15 


Reg f 


Dispatcher 
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3 
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Timer 
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7 
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CC/Dev 
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CSW | 
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2 






[ 






|tcb 


Timer 










6 


7 


I/O 
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CSW ( 











2 






1 










Timer 



Figure 37. Trace Table Entries (MVT) 
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SSM 
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A New TCB 
1 (CPU A) 
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1 (CPU B) 
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l(CPUA) 
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Timer 
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4 5 6 7 4 5 

Figure 38. Trace Table Entries (MVT with Model 65 multiprocessing) 



SVC entries provide the SVC old PSW and the SIO 

contents of registers and 1. The PSW 

offers you the hexadecimal SVC number (bits 

20-31), the CPU mode (bit 15), and the 

address of the SVC instruction (bytes 5-8), 

The contents of registers and 1 are 

useful in that many system macro 

instructions use these registers for 

parameter information. Contents of 

registers and 1 for each SVC interruption 

are given in Appendix B. 



I/O 



SVC and 
Program 



Trace Table Entries in MVT and M65MP ; 
Entries in an MVT trace table are 8 words 
long and represent occurrences of SIO, 
external, SVC, program, I/O, and dispatcher 
interruptions. You can identify what type 
of interruption caused an entry by looking 
at the fifth digit: 

= SIO 

1 = External 

2 = SVC 

3 = Program 

5 = I/O External 

D = Dispatcher 

Figure 40 gives some sample entries and 
their contents. 

In dumps of Model 65 Multiprocessing 
system, trace table entries differ as 
follows : 



7th word: 
8th word 
3rd word: 
4th word 
8th word 
6th word: 
7th word: 
8th word 
Dispatcher 6th word: 
7th word: 
8th word: 



5th word address of TCB. 
6th word: address of old TCB 

for CPU A. 

address of old TCB 

for CPU B. 

CPU identification 

(last byte) . 

contents of register 

15. 

contents of register 

0. 

CPU identification 

(last byte). 

address of old TCB 

for APU A. 

address of old TCB 

for CPU B. 

CPU identification 

(last byte) . 

address of new TCB 

for CPU A. 

address of new TCB 

for CPU B. 

CPU identification 

(last byte) . 
6th word: STMASK of other CPU. 
7th word: TQE if timer inter- 
rupt occurred. 
8th word: CPU identification 

(last byte) . If so, a 

program check at the 

instruction preceding 

that address caused 

the interruption. 
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SIO 



,190, ,0000^98, ,00000000 04000QOO f 



fn 



Condition Device CAW 
code address 



CSW 



I/O 













.FF060H 


<? 


0OQO320A, 


.0Q01F7Q8 


OCO0000O, 

















I/O old PSW 



CSW 



SVC number 



SVC 



.FFOSrW? 500T442A, .0003F3BC, ,00000050, 



SVC old PSW 



Indicates task switch 



gister Register 1 



Task 
Switch 



.FFO4F00O 00011750. .O0O0F1EO. .0000EE60, 



Dispatched new PSW | new TCB 



fold 



TCB 



Figure 39. Sample Trace Table Entries 
(MFT) 



Generalized Trace Facility 

The Generalized Trace Facility (GTF) traces 
system and application program events and 
records information about these events. 
Trace records can be stored internally — 
in a table similiar to the trace table of 
the Trace Option — or they can be recorded 
externally in a data set that becomes input 
to the IMDPRDMP service aid program. (When 
stored internally the trace table is 
formatted in ABEND/SNAP dumps.) The 
IMDPRDMP service aid edits and formats the 
GTF external trace records as specified in 
an EDIT control statement. 

This section describes the output of 
GTF; it does not tell how to use GTF. For 
a description of the functions performed by 
GTF and IMDPRDMP refer to the Service Aids 
publication. 



SIO entry identifier 



SIO 




Condition Device CAW 
code address 



CSW 



00004800 00000000 .00003660, ^1199D9E. 



TCB address Timer 



I/O entry 
identifier 

Device address 



I/O 



.FF065193 80000000, 


(00004688 ocoooooa ) 


.1 .. * \ 


1 

I/O old PSW 


1 
CSW 


1 oaxMeo ° "^ 


00003660 .61198E9E, 



Timer 



Entry identifier 
(SVC here) SVC number 

J 



SVC 
External 
Program 
Dispatcher 




SVC old PSW 



Register 15 Register 



00000038, 00000000 JP00l2Cf& ,081£P£6P, 



Register 1 



TCB address 



Timer 



Figure 40. Sample Trace Table Entries 
(MVT) 

System events traced by GTF in MFT, MVT, 
and MVT-M65MP systems are: 

10 interrupts 

SIO operations 

SVC interrupts 

Program interrupts 

External interrupts 

Task Switches by the system dispatcher 

SSM interrupts in multi- processing 

systems 



GTF MINIMAL TRACE RECORDS 

The following material describes the 
records produced under the minimal trace 
option (SYSM) of GTF. The formats 
described appear in both ABEND/SNAP dumps 
(under the heading GTF TRACE TABLE) and in 
IMDPRDMP output. Minimal trace records are 
produced for IO and PCI/IO, SIO, SVC, PGM, 
EXT, DSP, and SSM events. 
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10 and PCI/ 10 Minimal Trace Record 



(********) fOLA hhhhhhhh 



BflPCIf 0LD PSW hhhhhhhh hhhhhhhh CSW hhhhhhhh hhhhhhhh RQE TCBJhhhhhhhh) (OLD TCB hhhhhhhh 



OLB hhhhhhhh) 



Figure 41, 10 and PCI/IO Minimal Trace Record 



ft} 



10 \ 

PCI J 



appears in MVT-M65MP system records; 
identifies the CPU associated with the 
event . 



identifies the type of trace record. 



OLD PSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the 10 or PCI/IO 
interrupt occurred. 

CSW hhhhhhhh hhhhhhhh 

the channel status word associated 
with the 10 or PCI/IO interrupt being 
traced. 

{********} 
hhhhhhhh) 
N/A J 

******** 

indicates that an error occurred 
while gathering the information. 



hhhhhhhh 

is the address of the TCB of the 
task for which this I/O operation 
is being performed. 



N/A 



indicates the interrupt was 
unsolicited: either the I/O 
supervisor did not issue an SIO 
instruction to the device; or 
there is no valid UCB for the 
device. 



OLD TCB hhhhhhhh 

in MFT and MVT system trace records, 
the address of the TCB for the task 
that was in control when the interrupt 
occurred. 

in MVT-M65MP systems the OLA and OLB 
fields replace the OLD TCB field and 
contain the address of the TCB for the 
task in control of CPU A and CPU B 
respectively, at the time the 
interrupt occurred. 
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SIO Minimal Trace Record 



{» 



SIO CC/DEV/CAW hhhhhhhh hhhhhhhh CSW hhhhhhhhhhhhhhhh 



! ******** WoLA hhhhhhhh OLB hhhhhhhh) 
hhhhhhhh }{ OLD TCB hhhhhhhh \ 

N/A )(o ) 



Figure 42. SIO Minimal Trace Record 



{5} 



SIO 



appears in MVT-M65MP system records; 
identifies the CPU associated with the 
event. 



identifies the type of trace record. 



CC/DEV/CAW hhhhhhhh hhhhhhhh 

displays the SIO condition code, the 
device address, and the CAW (channel 
address word) for the I/O operation 
just initiated. 

The first four digits represent the 
condition code returned from the SIO 
operation; the next four digits 
represent the device address; and the 
last eight digits represent the CAW. 

CSW hhhhhhhh hhhhhhhh 

the channel status word associated 
with this event. 

{********! 
hhhhhhhh? 
N/A ) 



******** 

indicates that an error occurred while 
gathering the information. 



hhhhhhhh 

is the address of the TCB of the task 
for which this I/O operation is being 
performed. 

N/A 

indicates the interrupt was 
unsolicited, i.e., the I/O supervisor 
did not issue an SIO instruction to 
the device; or, there is no valid UCB 
for the device,. 

OLD TCB hhhhhhhh 

in MFT and MVT system trace records, 
the address of the TCB for the task 
that was in control when the interrupt 
occurred. 

In MVT-M65MP systems the OLA and OLB 
fields replace the OLD TCB field and 
contain the address of the TCB for the 
task in control of CPU A and CPU B 
respectively, at the time the 
interrupt occurred. 
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DSP Minimal Trace Record 



/ A \ . . iwua nnnnnnnn rtu 

<"> DSP t VES psw l hhhhhhhh hhhhhhhh R15/R0 hhhhhhhh hhhhhhhh Rl hhhhhhhh (NEW TCB hhhhhhhh 
l B J (NEW PSWJ 



/NUA hhhhhhhh NUB hhhhhhhh) 



Figure 43, DSP Minimal Trace Record 



m 



DSP 



appears in MVT-M65MP records; 
identifies the CPU associated with the 
event. 



identifies the type of record. 



NEW PSW hhhhhhhh hhhhhhhh 

the PSW for the task about to be 
dispatched . 

In a record obtained from a MVT-M65MP 
system this field will be labeled RES 
PSW. 

R15/R0 hhhhhhhh hhhhhhhh 

the contents of general purpose 



registers 15 and as they will be 
when the task being dispatched is 
given control. 

Rl hhhhhhhh 

the contents of general purpose 
register 1 as it will be when the task 
being dispatched is given control. 

NEW TCB hhhhhhhh 

the address of the TCB for the task 
about to be dispatched. 

In a record obtained from a MVT-M65MP 
system this field is replaced by the 
NUA and NUB fields containing the 
addresses of the tasks to be 
dispatched on CPU A and CPU B when 
processing resumes. 
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EXT Minimal Trace Record 



/******* it\ 



i^\ EXT OLD PSW hhhhhhhh hhhhhhhh R15/R0 hhhhhhhh hhhhhhhh Rl hhhhhhhh STMSK hhhhhhhh TQE TCbJ hhhhhhhh) 



Figure 44. EXT Minimal Trace Record 



{a} 



EXT 



appears in MVT-M65MP records; 
identifies the CPU associated with the 
event- 



identifies the type of trace record. 



OLD PSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the external 
interrupt occurred. 

R15/R0 hhhhhhhh hhhhhhhh 

the contents of general purpose 
registers 15 and at the time the 
interrupt occurred. 

Rl hhhhhhhh 

the contents of general purpose 
register 1 at the time the interrupt 
occurred. 



STMSK hhhhhhhh 

appears in MVT-M65MP records only; 
displays the SHOULDER TAP MASK at the 
time the interrupt occurred. 



{********) 
hhhhhhhh \ 
N/A ) 



******** 

indicates that an error occurred 
while gathering the information. 

hhhhhhhh 

is the address of the TCB of the 
task that requested this timer 
interrupt. 



N/A 



indicates the interrupt was other 
than a timer interrupt. 
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PGM Minimal Trace Record 



/ A j (OLA hhhhhhhh OLB hhhhhhhh) 

< B > PGM OLD PSW hhhhhhhh hhhhhhhh R15/R0 hhhhhhhh hhhhhhhh Rl hhhhhhhh (OLD TCB hhhhhhhh f 



Figure 45. PGM Minimal Trace Record 



{1} 



PGM 



appears in MVT-M65MP system records; 
identifies the CPU associated with the 
event . 



identifies the type of trace record. 



OLD PSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the program 
interrupt occurred. 

R15/R0 hhhhhhhh hhhhhhhh 

the contents of general purpose 
registers 15 and at the time the 
interrupt occurred. 



Rl hhhhhhhh 

the contents of general purpose 
register 1 at the time the interrupt 
occurred. 



OLD TCB hhhhhhhh 

the address of the TCB for the task 
that was in control when the interrupt 
occurred . 



In MVT-M65MP trace records this field 
is replaced by the OLA and OLB fields 
that contain, respectively, the 
address of the TCB for the tasks in 
control of CPU A and CPU B at the time 
the interrupt occurred. 
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SVC Minimal Trace Record 



|b) 



SVC OLD PSW hhhhhhhh hhhhhhhh R15/R0 hhhhhhhh hhhhhhhh 



(OLA hhhhhhhh OLB hhhhhhhh) 
Rl hhhhhhhh (OLD TCB hhhhhhhh / 



Figure 46. SVC Minimal Trace Record 



ft} 



SVC 



appears^ in MVT-M65MP system records; 
identifies the CPU associated with the 
event. 



identifies the type of trace record. 



OLD PSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the interrupt 
occurred. The SVC number, e.g., SVC 
51, is represented by the last two 
hexadecimal digits in the first word. 

R15/R0 hhhhhhhh hhhhhhhh 

the contents of general purpose 



registers 15 and at the time the 
interrupt occurred. 

Rl hhhhhhhh 

the contents of general purpose 
register 1 at the time the interrupt 
occurred. 

OLD TCB hhhhhhhh 

the address of the TCB for the task 
that issued the SVC. 

In MVT-M65MP systems the OLA and OLB 
fields replace the OLD TCB field and 
contain the address of the TCB for the 
task in control of CPU A and CPU B 
respectively, at the time the 
interrupt occurred. 
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SSM Minimal Trace Record 



® 



SSM LK C OPSW hhhhhhhh hhhhhhhh R15/R0 hhhhhhhh hhhhhhhh Rl hhhhhhhh OLA hhhhhhhh OLB hhhhhhhh 



Figure 47. SSM Minimal Trace Record 



ft} 



SSM 



IK c 



indicates the CPU associated with the 
event . 



identifies the type of trace record. 



CPU affinity byte: 

A indicates CPU A executing 

disabled. 

B indicates CPU B executing 

disabled. 

Neither CPU executing disabled. 



OPSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the interrupt 
occurred. Obtained from the CPU on 
which the interrupt occurred. 

R15/R0 hhhhhhhh hhhhhhhh Rl hhhhhhhh 
The contents of general purpose 
registers 15, 0, and 1 from the CPU on 
which the interrupt occurred, at the 
time the interrupt occurred. 

OLA hhhhhhhh OLB hhhhhhhh 

the addresses of the TCBs of the tasks 
in control in CPU A and CPU B 
respectively at the time the interrupt 
occurred. 
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GTF COMPREHENSIVE TRACE RECORDS 

The following material describes the 
records produced when comprehensive tracing 
is specified at the invoking of GTF 
(MODE=EXT).. The formats described appear 



in the output from IMDPRDMP service aid 
processing of the data recorded by GTF. 

Comprehensive trace records are produced 
for 10, PCI/IO, SIO, DSP, EXT, PGM, SSM, 
and SVC events. 
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10 and PCI/10 Comprehensive Trace Record 



m 



PCI/ 



cuu OLD PSW hhhhhhhh hhhhhhhh 



{********■) 

JOBN< CCCCCCCC/ 



(n/a 



! ******* *| / 0LA hhhhhhhh OLB hhhhhhhh) 
cccccccc^ (OLTCB hhhhhhhh f 

N/A 



^ 



/**■****** ******** ******** \ /********) 

CSW hhhhhhhh hhhhhhhh RQE<hhhhhhhh hhhhhhhh hhhhhhhhj RQE TCB{hhhhhhhh> SENS/hhhhhhhhJ 



(N/A 






(N/A 



Figure 48. 10 and PCI/IO Comprehensive Trace Record 



® 



This field appears only in MVT-M65MP 
system I/O or PCI trace records and 
identifies the computer associated 
with the event. 



(ID \ 

iPClf 



This field identifies the type of 
trace record — input/output (10) or 
program controlled interrupt (PCI). 



cuu 



This field displays the device address 
for the device associated with the 
interrupt in channel/unit form. 

OLD PSW hhhhhhhh hhhhhhhh 

This field displays the program status 
word that was current at the time the 
10 or PCI interrupt being traced, 
occurred. 

{cccccccc} 
********> 
N/A ) 

This field has three possible entries, 
as follows: 

cccccccc 

is the one to eight character 
name of the job associated with 
the interrupt being traced. 

******** 

asterisks indicate that a bad 
control block chain prevented the 
jobname from being obtained. 



N/A 



in PCI trace records N/A 
indicates that the interrupt was 
issued by the system and there is 
no associated jobname; in 10 
interrupt trace records N/A 
indicates either a system issued 
interrupt as for PCI or an 
interrupt issued without a valid 



UCB for the device issuing the 
interrupt. 



{cccccccc J 
********\ 
N/A ) 



This field has three possible entries, 
as follows: 

cccccccc 

is the name of the DD statement 
associated with the interrupt 
being traced. 

******** 

asterisk indicate that a bad 
control block chain prevented the 
data definition name from being 
obtained. 

N/A 

N/A appears in the DDNM field for 
one of the following reasons: 

• An interrupt was issued without 
a valid UCB for the device 
issuing the interrupt. 

• The post bit in the UCB is 
•off.' 

• The data event block (DEB) 
pointer to the TCB is set to 0. 

• The DCB is not opened. 

• The DCB TIOT offset is outside 
the valid range, 

• The TCB TIOT pointer is set to 
0. 

• The DDNAME in the TIOT is not 
recorded in EBCDIC characters. 

OLTCB hhhhhhhh 

In MFT and MVT system trace records 
this field displays the address of the 
TCB that was current at the time the 
10 or PCI interrupt being traced, 
occurred. 

In MVT-M65MP system 10 and PCI trace 
records the following fields replace 
the OLTCB field: 
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OLA hhhhhhhh 

This field displays the address 
of the A computer TCB that was 
current when the 10 or PCI 
interrupt occurred. 

OLB hhhhhhhh 

This field displays the address 
of the B computer TCB that was 
current when the 10 or PCI 
interrupt occurred. 

CSW hhhhhhhh hhhhhhhh 

This field displays the channel status 
word from permanent storage location 
64. 

(hhhhhhhh hhhhhhhh hhhhhhhh) 

RQE\******** ******** ********> 
( N/A ) 

This field has three possible entries 
as follows: 

hhhhhhhh hhhhhhhh hhhhhhhh 

is the content of the first three 
words of the Request Queue 
Element associated with the 10 or 
PCI interrupt. 

******** ******** ******** 

asterisks indicate that a bad 
control block chain prevented the 
RQE information from being 
obtained. 



N/A 



indicates that the interrupt was 
issued without a valid UCB for 
the device issuing the interrupt. 



(hhhhhhhh) 

RQE TCB<********> 

( N/A J 



This field has three possible entries 
as follows: 



hhhhhhhh 

is the address of the TCB 
associated with the Request Queue 
Element 

******** 

asterisks indicate that a bad 
control block chain prevented the 
TCB address from being obtained. 

N/A 

indicates that the interrupt was 
issued without a valid UCB for 
the device issuing the interrupt. 

SENS /hhhhhhhh) 
I N/A ) 

This field has two possible entries as 
follows: 

hhhhhhhh 

is the content of the four sense 
bytes in the UCB beginning at UCB 
+22 which describe the 10 or PCI 
interrupt being traced. 



N/A 



indicates that the interrupt was 
issued without a valid UCB for 
the device issuing the interrupt. 
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SIO Comprehensive Trace Record 



, A v fOLA hhhhhhhh OLB hhhhhhhh) 

<jH SIO cuu CC hh CAW hhhhhhhh JOBNfccccccccMOLTCB hhhhhhhh J 

CSW hhhhhhhh hhhhhhhh RQE hhhhhhhh hhhhhhhh hhhhhhhh RQE TCB hhhhhhhh 



Figure 49. SIO Comprehensive Trace Record 



ft} 



SIO 



cuu 



appears in MVT-M65MP system trace 
records; identifies the computer 
associated with the event. 



the type of trace record. 



the device address in channel /unit 
form for the device associated with 
the record. 



CC hh 

hh - is the condition code set by the 
SIO event. 

CAW hhhhhhhh 

the channel address word associated 
with this event — taken from 
permanent storage location 72. 

JOBN i cccccccc \ 
\ N/A J 

cccccccc 

is the one to eight character 
jobname of the job associated 
with this event. 



N/A 



indicates the SIO was issued by 
the system and there is no 
associated jobname. 



OLTCB hhhhhhhh 

in MFT/MVT systems the address of the 
TCB that was current when the SIO was 
issued. 



in MVT-M65MP systems the OLA and OLB 
fields replace the OLTCB field. 



OLA hhhhhhhh 

is the A computer address of the 
TCB that was current when the SIO 
was issued. 



OLB hhhhhhhh 

is the B computer address of the 
TCB that was current when the SIO 
was issued. 



CSW hhhhhhhh hhhhhhhh 

the channel status word associated 
with this event — taken from 
permanent storage location 64. 

RQE hhhhhhhh hhhhhhhh hhhhhhhh 

the first three words of the Request 
Queue Element associated with the SIO 
operation. 

RQE TCB hhhhhhhh 

the address of the TCB associated with 
the request queue element. 
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DSP Comprehensive Trace Record 



ft} 



(WAITTCB 

ISVC-ccccJfNUA hhhhhhhh NUB hhhhhhhh) 
DSP RES PSW hhhhhhhh hhhhhhhh JOBN fcccccccci MODNJSVC-RES ((NUTCB hhhhhhhh JPRTY hh 

\N/A f j**IRB***( 

I ccccccccj 
I Icccccccl 



Figure 50. DSP Comprehensive Trace Record 



ft} 



DSP 



MVT-M65MP systems only. Identifies 
the computer associated with the 
event. 



the type of trace record. 



RES PSW hhhhhhhh hhhhhhhh 

the PSW for the task about to be 
dispatched. If this task was 
interrupted at some previous point in 
time, then this was the current PSW at 
the interrupt. 

JOBNf cccccccc) 
l N/A J 

cccccccc 

is the eight character name of 
the job associated with the task 
being dispatched. 



N/A 



indicates the task switch is for 
a system task; no jobname is 
available. 



[WAITTCB 
ISVC-cccc] 
MODN JSVC-RES 
l**IRB***| 
[cccccccc' 
, Iccccccc , 



WAITTCB 

the WAIT task is about to be 
given control. 

SVC-cccc 

indicates a type 3 or 4 SVC is 
about to get control; cccc is the 
last four characters in the 
module name. 

SVC-RES 

indicates a resident type SVC 
routine is about to be given 
control. 



**IRB*** 

an asynchronous routine is about 
to be dispatched and the module 
name is not available. 

cccccccc 

an asynchronous routine is about 
to be dispatched and the module 
name is not available. 

cccccccc 

in MVT systems the eight 
character module name from the 
CDE associated with the task to 
be dispatched; or, the name of an 
error exit routine from the SIRB 
associated with the task. 

in MPT systems the eight 
character name from the LRB, 
LPRB, PRB or FRB associated with 
the task being dispatched; or an 
error exit routine name from the 
SIRB associated with the task. 

Iccccccc 

indicates that error fetch is in 
the process of loading an error 
recovery module. The last seven 
characters of the module name are 
shown. 

NUTCB hhhhhhhh 

the address of the new TCB — the TCB 
of the next-to-be-dispatched task. 

in MVT-M65MP systems the following 

fields replace the NUTCB field: 

NUA hhhhhhhh 

the address of the TCB of the 
next-to-be-dispatched task in the 
A computer. 

NUB hhhhhhhh 

the address of the TCB of the 
next-to-be-dispatched task in the 
B computer. 



PRTY hh 



hh 



the dispatching priority of the 
next-to-be-dispatched task. 
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EXT Comprehensive Trace Record 



ft} 



! WAITTCB 
SVC-cccclfOLA hhhhhhhh OLB hhhhhhhh) 
SVC-RES ((OLTCB hhhhhhhh JSTMSK hhhhhhhh 

**IRB***[ 
ccccccccj 
Iccccccc] 



hhhhhhhh} EXIt] hhhhhhhh) 
N/A ) (N/A ) 



Figure 51. EXT Comprehensive Trace Record 



$ 



EXT 



This field appears only in MVT-M65MP 
system EXT trace records and 
identifies the computer associated 
with the event. 



This field identifies the trace record 
as an EXT trace record. 



OLD PSW hhhhhhhh hhhhhhhh 

This field displays the program status 
word that was current at the time the 
external interrupt occurred. 

JOBN f cccccccc) 
\ N/A J 

This field has two possible entries as 
follows: 

cccccccc 

is the one to eight character 
name of the job associated with 
the event. 



N/A 



indicates that the interrupt was 
issued by the system and there is 
not associated job name. 



WAITTCB 
, SVC-cccc J 
MODN J SVC-RES 

|**IRB***| 
'cccccccc 

Iccccccc 



WAITTCB 

The WAIT task was interrupted. 

SVC-cccc 

A type 3 or 4 SVC routine was 
interrupted; cccc is the last 
four characters of the routine 
name. 



SVC-RES 

a resident SVC routine was 
interrupted. 



**IRB*** 

the EXT interrupt occurred during 
execution of an asynchronous 
routine with an associated IRB. 



cccccccc 

in MVT systems the eight 
character name of the module that 
was interrupted - taken from the 
CDE associated with the task; or 
the name of an error routine - 
taken from the SIRB associated 
with the task. 



in MPT systems the eight 
character name of the module that 
was interrupted - taken from 
either the LRB, LPRB, PRB f or 
FRB; or the name of an error 
routine - taken from the SIRB 
associated with the task. 

Iccccccc 

indicates that error fetch was in 
the process of loading an error 
recovery routine when the 
interrupt occurred. The last 
seven characters of the module 
name are shown. 

OLTCB hhhhhhhh 

In MFT/MVT systems the address of the 
TCB that was current when the 
interrupt occurred. 

In MVT-M65MP systems the OLA and OLB 
fields replace the OLTCB field. 

OLA hhhhhhhh 

is the address of the TCB in the 
A computer that was current when 
the interrupt occurred. 
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OLB hhhhhhhh 

is the address of the TCB in the 
B computer that was current when 
the interrupt occurred. 

STMSK hhhhhhhh 

In MVT-M65MP systems only - the 
•shoulder tap* mask from location 
X^BC* in the other computers prefix,. 

(N/A ) 

TQEFLG/TCB< ********> 

(hhhhhhhh) 

hhhhhhhh 

is the first word of the timer 
queue element (TQE). The first 
byte of the word is the TQEFLGS 
and the remaining three bytes the 
TQETCB, which is the address of 
the TCB for the task in which 
this timer element is being used. 



******** 

asterisks indicate that a bad 
control block chain prevented the 
information from being obtained. 



N/A 



indicates that this EXT interrupt 
was not caused by the timer. 



(hhhhhhhh) 

EXIT{ N/A ( 

(********) 



hhhhhhhh 

is the address of the exit 
routine - taken from the eighth 
word of the TQE. 



N/A 



indicates that this EXT interrupt 
was not caused by the timer. 



******** 

asterisks indicate that a bad 
control block chain prevented the 
information from being obtained. 
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PGM Comprehensive Trace Records 



G} 



PGM ccc OLD PSW hhhhhhhh hhhhhhhh 



JOBN/cccccccc\ 
In/a j 



(WAITTCB \ 

ISVC-ccccJ (OLA hhhhhhhh OLB hhhhhhhh) 
MODNJSVC-RES M OLTCB hhhhhhhh J 

I **IRB***| 
f ccccccccl 
, Iccccccc/ 



RO hhhhhhhh 
R8 hhhhhhhh 



Rl hhhhhhhh R2 hhhhhhhh R3 hhhhhhhh R4 hhhhhhhh R5 hhhhhhhh R6 hhhhhhhh R7 hhhhhhhh 
R9 hhhhhhhh RIO hhhhhhhh Rll hhhhhhhh R12 hhhhhhhh R13 hhhhhhhh R14 hhhhhhhh R15 hhhhhhhh 



Figure 52. PGM Comprehensive Trace Record 



ft} 



PGM 



ccc 



MVT-M65MP systems only; identifies the 
computer associated with the 
interrupt. 



the type of trace record. 



the completion code for the program 
interrupt. 

OLD PSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the program 
interrupt occurred. 

fcccccccc) 
JOBN( N/A / 

cccccccc 

is the one to eight character 
jobname of the job associated 
with this event. 



N/A 



indicates a system task program 
checked and no jobname is 
available. 



WAITTCB 
i SVC-cccc 
MODNJSVC-RES 
|**IRB*** 
[cccccccc 
Iccccccc 



SVC-CCC 

A type 3 or 4 SVC routine was 
interrupted; cccc is the last 
four characters of the routine 
name. 

SVC-RES 

a resident SVC routine was 
interrupted. 



**IRB*** 

the program check interrupt 
occurred in an asynchronous 
routine with an associated IRB. 



cccccccc 

in MVT systems the eight 
character name of the module that 
was interrupted - taken from the 
CDE associated with the task; or, 
the name of an error routine - 
taken from the SIRB associated 
with the task. 

Iccccccc 

indicates that error fetch was in 
the process of loading an error 
recovery routine when the 
interrupt occurred. The last 
seven characters of the module 
name are shown. 

OLTCB hhhhhhhh 

in MFT/MVT systems the address of the 
TCB that was current when the 
interrupt occurred. 

In MVT-M65MP systems the OLA and OLB 
fields replace the OLTCB field. 

OLA hhhhhhhh 

is the A computer address of the 
TCB that was current when the 
interrupt occurred. 

OLB hhhhhhhh 

is the B computer address of the 
TCB that was current when the 
interrupt occurred. 

RO hhhhhhhh 
to 

R15 hhhhhhhh 

the content of general purpose 
registers zero through fifteen at the 
time of the interrupt. 
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SSM Comprehensive Trace Record 



ft} 



SSM OLD PSW hhhhhhhh 



[WAITTCB 
I SVC-cccc | 
JOBNfccccccccl MODNlSVC-RES 

(N/A / j**IRB***| 
[cccccccc ' 
I Iccccccc , 



OLA hhhhhhhh OLB hhhhhhhh LKID C 



Figure 53. SSM Comprehensive Trace Record 



ft} 



SSM 



identifies the computer associated 
with the SSM interrupt. 



identifies this trace record as an SSM 
trace record. 



OLD PSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the set system 
mask instruction was issued. 

JOBN (cccccccc) 
\ N/A f 

cccccccc 

is the one to eight character 
name of the job associated with 
SSM interrupt. 



N/A 



indicates that the system 
originated the interrupt and 
there is no associated jobname. 



WAITTCB 
SVC-cccc 
MODN^SVC-RES 
**IRB*** 
Iccccccc 



WAITTCB 

the WAIT task was interrupted. 

SVC-cccc 

a type 3 or 4 SVC routine was 
interrupted; cccc is the last 
four characters of the routine 
name. 

SVC-RES 

a resident SVC routine was 
interrupted. 



**IRB*** 

the SSM interrupt occurred during 
execution of an asynchronous 
routine with an associated IRB. 



cccccccc 

the eight character name of the 
module that was interrupted - 
taken from the content directory 
element (CDE) for the task; or 
the name of an error routine - 
taken from the SIRB associated 
with the task. 



Iccccccc 

indicates that error fetch was in 
the process of loading an error 
recovery routine when the 
interrupt occurred. The last 
seven characters of the module 
name are shown. 



OLA hhhhhhhh 

is the A computer address of the TCB 
that was current when the interrupt 
occurred. 



OLB hhhhhhhh 

is the B computer address of the TCB 
that was current when the interrupt 
occurred. 



LKID C 

CPU affinity byte: 

A indicates CPU A executing 

disabled. 
B indicates CPU B executing 

disabled. 
Neither CPU executing disabled. 
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TIME AND LOST EVENT RECORDS 

GIF produces two types of time records and 
a lost event record as follows: 



TIME ddddd.dddddd 



appears on the last line of every 
event record if TIME=YES was specified 
in the GTF start command, and 
designates in decimal the number of 
seconds and microseconds since the 
last midnight - 



***DATE: DAY ddd YEAR dddd TIME dd.dd.dd 



This timestamp record appears at the 
beginning of the printout of each 
buffer filled by GTF and represents 
the time the first record was placed 
in the buffer. 



DAY ddd 

is the Julian date. 



YEAR dddd 

is the year. 



TIME dd.dd.dd 

is the time since midnight in a 
twenty-four hour format 
(hours . minutes. s econds) . 

*** LOST EVENTS: NUM dddddddddd TIME 
dd.dd.dd (GTF DISABLED] 

The lost event record appears whenever 
GTF loses records, whether it is 
because the GTF buffers overflowed or 
because GTF was temporarily disabled 
by ABEND. The record is not produced 
if GTF terminates when the buffers are 
full. 

NUM dddddddddd 

is the number of records that 
were lost; one to ten decimal 
digits - 

TIME dd.dd.dd 

is the time GTF resumed 
recording; 24-hour format 
starting at midnight. 

GTF DISABLED 

appears only if the events were 
lost because GTF was temporarily 
disabled, e.g., ABEND temporarily 
disables GTF in order to format 
GTF output for an ABEND dump. 
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HEXADECIMAL FORMAT RECORD 



HEXFORMAT 
USER 
SYSTEM 
SUBSYS 



AID hh FID hh EID hh 



hhhhhhhh hhhhhhhh hhhhhhhh 



/ 



hhhhhhhh 



Figure 54. Hexadecimal Format Record 



Under some circumstances IMDPRDMP formats 
and prints GTF records in hexadecimal 
notation. The conditions under which GTF 
records are formatted and printed in 
hexadecimal format by IMDPRDMP are 
presented in the discussion of the 
hexformat record that follows: 

HEXFORMAT 

This label identifies a record dumped 
in hex format at the request of the 
user on a GTRACE macro. This request 
was made by not specifying a format 
appendage, that is FID=00. 

USR 

This label identifies this record as 
dumped in hexformat because the user 
requested a format appendage on the 
GTRACE macro that could not be found. 
This format appendage was identified 
by FID=hh, and therefore its name is 
IMDUSR hh. 

SYSTEM 

This label identifies a record that 
was dumped in hex format because 
either it is a GTF error record or the 
format appendage for it has been 
scratched by the user. If relative 
bytes 0, 1 or 8, 9 contain X'EEEE*, 
then this is an error record produced 
by GTF. This error record was 
produced as a result of an 
unrecoverable error in a GTF data 
gathering routine. When the error was 
encountered message IHL118I was 
written on the master system console 
indentifying the error and the action 
taken. This message is not issued if 
the error occurred while building a 
comprehensive SVC trace record. 



Except for comprehensive SVC records, 
this was the last record of its type 
produced during the run of GTF that 
produced it. If the X'EEEE* were not 
in the record,, then it was dumped in 
hexformat because the IMDPRDMP format 
appendage that formats this type of 
record was not found by IMDPRDMP. 

SUBSYS 

This label identifies this record as 
dumped in hexformat because the 
subsystem format appendage requested 
by the subsystem on a GTRACE was not 
found by IMDPRDMP. The request was 
made via FID=hh, and therefore, it's 
name is IMDUSRhh. 

AID hh 

This field contains the AID of this 
record, and should always be X* FF*. 
The AID is the application identifier, 
and GTF's is always X^F*. 

FID hh 

This field contains the FID, or format 
identifier. It is appended to 
•IMDSYS' or •IMDUSR* to obtain the 
name of the format appendage that was 
to have formatted this record. 

EID hhhh 

This field contains the EID, or event 
identifier, for this record. The EID 
uniquely identifies the event that 
produced this record. 

hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 

up to 64 words (256 bytes) of record 
in the GTF internal format. The 
internal format of GTF records is 
available in the Service Aids PLM. 
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GTF SVC COMPREHENSIVE TRACE RECORDS 

There are four groups of GTF SVC 
Comprehensive Trace records. 

Group 1 — Those with Basic Fields 

Group 2 — Those with Basic Fields plus 

a DDNAME Field 

Group 3 — Those with Basic Fields plus 

a Parameter List Field 

Group 4 — Those with Basic Fields plus 

Variable Field (s) 

The following sub-index lists the SVCs in 
sequence, identifies the group to which 
they belong, and gives the page where 
register contents and other variable fields 
are noted. 



SVC # 


Group 
4 


Paqe 





190 


1 


3 


182 


2 


1 


170 


3 


1 


171 


4 


3 


182 


5 


3 


183 


6 


4 


190 


7 


4 


190 


8 


4 


190 


9 


4 


191 


10 


3 


171 


11 


1 


171 


12 


1 


171 


13 


4 


191 


14 


4 


191 


15 


4 


191 


16 


4 


191 


17 


4 


192 


18 


3 


183 


19 


3 


183 


20 


3 


183 


21 


4 


192 


22 


3 


183 


23 


3 


183 


24 


2 


181 


25 


4 


192 


26 


4 


193 


27 


4 


194 


28 


4 


195 


29 


4 


195 


30 


4 


195 


31 


2 


181 


32 


4 


195 


33 


4 


195 


34 


1 


171 


35 


3 


183 


36 


1 


171 


37 


3 


184 


38 


1 


171 


39 


3 


184 


40 


3 


184 


41 


4 


196 


42 


4 


196 


43 


1 


171 


44 


4 


197 



SVC # 


Group 


Paqe 


45 


3 


185 


46 


1 


172 


47 


3 


185 


48 


3 


185 


49 


1 


172 


50 null 






51 


4 


197 


52 


1 


172 


53 


2 


181 


54 


4 


198 


55 


2 


181 


56 


3 


186 


57 


2 


181 


58 


2 


181 


59 


1 


172 


60 


3 


186 


61 


1 


172 


62 


4 


198 


63 


3 


187 


64 


3 


187 


65 


4 


198 


66 


4 


199 


67 


4 


199 


68 


1 


172 


69 


2 


181 


70 


3 


187 


71 


4 


199 


72 


1 


173 


73 


3 


187 


74 


3 


187 


75 


4 


199 


76 


1 


173 


77 


3 


187 


78 


4 


200 


79 


1 


173 


80 


3 


188 


81 


4 


200 


82 


4 


200 


83 


1 


173 


84 


1 


173 


85 


1 


173 


86 


4 


201 


87 


3 


188 


88 


4 


202 


89 


4 


202 


90 


3 


188 


91 


1 


173 


92 


1 


173 


93 


1 


174 


94 


1 


175 


95 


1 


177 


96 


3 


188 


97 


1 


178 


98 


4 


202 


99 


3 


189 


100 


1 


178 


101 


1 


179 


102 


3 


189 


103 


1 


179 


104 


1 


179 


105 


1 


180 


109 


1 


180 


116 


1 


180 


117 


1 


180 
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SVC Comprehensive Trace Records Group 1 — Basic Fields 



i A \ /OLA hhhhhhhh OLB hhhhhhhty 

<g> SVC ddd OLD PSW hhhhhhhh hhhhhhhh JOBN cccccccc MODN cccccccc (OLTCB hhhhhhhh / 



R15/R0 hhhhhhhh hhhhhhhh Rl hhhhhhhh 



Figure 55- Basic SVC Comprehensive Trace Record 



{5} 



this field appears only in MVT-M65MP 
records and identifies the CPU 
associated with the event. 



SVC nnn 

the decimal number of the SVC 

OLD PSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the SVC interrupt 
occurred. When SVC processing is 
completed, operation is resumed under 
control of this PSW. 

cccccccc > 

N/A ) 

asterisks indicate an error occurred 
while attempting to retrieve the 
jobname, e.g., an incorrect TIOT 
address in the TCB could result in 
asterisks being placed in this field. 

cccccccc is the eight character 
jobname of the job issuing the SVC. 

N/A indicates that the SVC was issued 
by the system and there is no 
associated jobname. 

**IRB*** 
SVC-RES 
MODNjSVC-nnnn| 

*CCCCCCC| 

cccccccc I 

N/A 
******** 

**IRB*** indicates the SVC was issued 
by an asychronously executed routine 
with an associated IRB. 

SVC-RES indicates the SVC was issued 
by a resident SVC with an associated 
SVRB. 

SVC-nnnn indicates the SVC was issued 
by a transient SVC module with an 
associated SVRB. nnnn denotes the 



last four characters of the module 
name . 

♦ccccccc indicates that error fetch is 
in the process of loading an error 
recovery module, ccccccc is the last 
seven characters of the module name. 

cccccccc is, in MVT systems, the eight 
character name of the module issuing 
the SVC — taken from the CDE 
associated with the task; or thB name 
of an error routine • — taken from the 
SIRB associated with the task. 

In MFT systems the module name is 
taken from the LRB, LPRB, PRB, or FRB 
and the error routine name is taken 
from the SIRB associated with the 
task. 

N/A indicates the RB CDE pointer was 
zero. 

******** indicates that an error 
occurred while attempting to retrieve 
the module name. 

OLTCB hhhhhhhh 

the address of the TCB that was 
current when the SVC was issued. 

In MVT-M65MP systems the OLA and OLB 
fields replace the OLTCB field and 
indicate the addresses of the TCBs 
that were current in CPU A and CPU B 
when the SVC was issued. 



R15/R0 hhhhhhhh hhhhhhhh Rl hhhhhhhh 
the contents of registers 15, 0, 
when the SVC was issued. 



and 1 



SVC Comprehensive Trace Records Group 1 — 
Basic Fields 



SVC 2 (POST) 



R15 contains no applicable 

information. 

R0 contains the completion code to be 

placed in the ECB. 

Rl contains the address of the ECB to 

be posted. 
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SVC 3 (EXIT) 



registers contain no applicable 
information. 



svc 10 (regmain: 

R15 contains no applicable 
information. 

R0 contains the number of the subpool 
requested in the high order byte , and 
the number of bytes requested in the 
low order three bytes. 
Rl contains any negative value if the 
request is for a GETMAIN; contains the 
address of the storage to be freed if 
the request is for a FREEMAIN; 
contains zero value if the request is 
for a FREEMAIN for an entire subpool. 

SVC 11 (TIME) 

R15 contains no applicable 

information. 

R0 contains no applicable information. 

Rl contains flag bits in the low order 

byte that designate how the time is to 

be returned in Register 0. 

If the low order byte is: 



x f 00 



x f or 



x"02' 



register is to contain a 
32 bit unsigned binary 
number representing the 
number of timer units that 
have elapsed. (A timer unit 
is 26.04 micro- seconds). 



register is to contain 
elapsed time in hundredths 
of a second. 



register is to contain 
packed decimal digits 
representing elapsed time in 
hours, minutes, seconds, 
tenths of a second, and 
hundredths of a second 
(HHMMSSth). 



SVC 12 (SYNCH) 



R15 contains the address of the entry 
point for the processing program that 
is to be given control. 
R0 contains no applicable information. 
Rl contains no applicable information. 



SVC 34 (MGCR) 



R15 contains no applicable 
information. 

R0 and Rl contents are as follows: 
Rl, if positive, contains a 
pointer to the command buffer of 
the command to be processed. R0 
is not used in this case. 



If Rl is negative and R0 is zero, 
then Rl contains a pointer to the 
CSCB that is to be either added 
to the chain or deleted from the 
chain. 

If Rl is negative and R0 is 
positive, then Rl contains a 
pointer to the CIB that is to be 
added to or deleted from the 
chain. R0 contains a pointer to 
the beginning of the chain. 

If Rl is negative and R0 is 
negative, then R0 contains a 
pointer to the CIB in which the 
CIB count is to be set and Rl 
contains the value to which the 
CIB count is to be set. 

SVC 36 (WTL) 

R15 contains no applicable information. 
R0 contains no applicable information. 
Rl if positive, contains a pointer to 
the user record that is to be written to 
the system log dataset. 

If negative, contains a pointer to 
the LCA indicating either 
initialization, (both data sets 
have to be opened) , or data set 
switching is required. 

SVC 38 (TTROUTER) 

Registers 15, 0, and 1 do not contain 
any applicable information. 

SVC 43 (CIRB) 



R15 contains no applicable 
information. 

R0 contains the entry point address of 
the user's asynchronous exit routine. 
Rl contains option bit flags in the 
high order half word and the size of 
the work area requested (in double 
words) in the low order half word. 

Flag settings are: 

flag byte 1 

1 DIRB 

CIRB 

.1000... bits 1-4 always set 

as shown 
. .... 1 . . problem program key 

...... . . supervis or key 

......1. problem program state 

......0. supervisor state 

....... 1 save area for 

registers requested 
no save area 

requested 

flag byte 2 

xxxx. . xx reserved 

. ...1... do not return IQEs at 

exit 
.....1.. return IQEs at exit 
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SVC 46 (TTIMER) 

R15 contains no applicable 

information. 

RO contains no applicable information,. 

Rl the low order three bytes carry 

code determining how TTIMER should 

work,, as follows: 



x'OO' 



x'Ol' 



x*02' 



the time remaining in the 
current tasks time interval 
is to be returned in 
register 0; the interval 
timer is not to be canceled. 



the current task's time 
interval is to be canceled. 



the time interval of a 
related task is to be 
canceled. 



SVC 49 (TTOPEN) 

Registers 15, 0, and 1 do not contain 
any applicable information. 



SVC 52 (Restart/SMB Reader). 

Registers 15 and have no applicable 
information. 

Rl contents are as follows: 

If SVC 52 is issued by the 
Initiator for the purpose of 
reading SMBs (containing JCL) for 
an automatic step or checkpoint 
restart, register 1 points to a 
job queue DCB, SMB buffer, and 
general work space. 

If SVC 52 is issued from module 
IEFRSTRT to initiate a check 
point restart, register 1 
contains a pointer to a parameter 
list. 

SVC 59 (OLTEP) 



R15 contains no applicable 

information. 

RO contains a pointer to a three word 

parameter list, which, in turn 

contains pointers as follows: 

Word 1 — pointer to UCB 
Word 2 — pointer to DEB 
Word 3 — pointer to IECIOLTS 
(I/O interrupt handler) . 
Rl contains a call code used to 
locate the particular OLTEP function 
requested. The value will be greater 
than x*00' and equal or less than 
x*94'. 



SVC 61 (TSAV) 

Registers 15 and have no applicable 
information. 

Rl contains zeroes if the routine is 
being entered from the Overlay 
Supervisor,. 

Rl contains the address of the DCB 
used to fetch the module (set to a 
negative value) if the routine is 
being entered from the Contents 
Supervisor. 

SVC 68 (SYNADAF/SYNADRLS) 



Entry from SYNADAF : 

R15 contains a flag byte in the 
high-order position and three bytes of 
user data or an address of an entry 
point to the SYNAD routine, 

The flag byte contains codes as 
follows : 

00 EXCP request 

01 BPAM request 

02 BSAM request 

03 QSAM request 

04 BDAM request 

05 BISAM request 

06 QISAM request 

07 BTAM request 

08 QTAM request 

09 GAM request 

R0 contains, in the three low order 
bytes, the address of the DECB (BSAM, 
BPAM, BDAM) or the address of the IOB 
(BISAM, QISAM, QSAM). 

Additionally, when a QSAM request is 
made, the high-order byte contains the 
offset of the first CCW in the IOB. 

Rl contains a flag byte and the 
address of the DCB in the high- order 
byte and the three low-order bytes 
respective ly . 

The flag byte bit settings are: 



00000000 


BISAM and QISAM 




error caused by input 




error caused by 




output 


..1..... 


error caused by BSP, 




CNTRL, or POINT 


• • • JL • • • • 


record had been 




successfully read 


. . . . l . . . 


INVALID request 


1 . . 


PT conversion - 




invalid character 




BDAM only - hardware 




error 




BDAM only - no space 




for record 
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Entry from SYNADRLS : 

Registers and 1 have no applicable 

information. 

R15 contains x*FF* in the high- order 
byte, indicating the SVC routine is 
being entered from the SYNADRLS macro 
instruction and three bytes of user 
data,. 



SVC 72 (CHATR) 



Registers 15 and have no applicable 
information. 

Rl contains the address of a parameter 
list with the following structure: 

Offset 






address of parameter 




list* 8 


4 


address of DCB 


8 


module name for XCTL 


16 


code for OPEN/CLOSE (1 




byte) ; address of OCM 




entry (3 bytes) 


20 


address of UCM 


24 


address of return 


SVC 76 (IFBSTAT) 





R15 contains no applicable 
information. 

The content and applicability of 
Registers and 1 vary with the 
presence or absence of RDE 
(Reliability Data Extractor) routines 
in the control program. 

If RDE is present: 

R0 contains a positive or 8. 
Rl has no applicable information. 

A positive in R0 indicates that 
EOD recording is requested; a 
positive 8 indicates that I PL 
recording is requested. 

If RDE is not present: 

R0 contains a negative number 
representing the length in bytes 
of a record to be placed in the 
SYS1.LOGREC data set. 
Rl contains the address of the 
record to be written. 

SVC 79 (STATUS) 



R15 has no applicable information. 

R0 contains the START/STOP code; 07 
for START, 06 for STOP 

Rl contains, in its three low order 
bytes, the address of the subtask TCB 
which is to have its START/STOP count 
adjusted. 



SVC 83 (SMFWTM) 

Registers 15 and contain no 
applicable information. 



Rl contains a pointer as follows: 
If positive a pointer to the 
record that is to be written to 
the SMF data set. 

if negative a pointer to the SMCA 
indicating either initialization 
or processing for a SWITCH 
command -to switch SMF data sets. 

SVC 84 (Restart Address Routine), 

SVC 84 is issued by the GPS Graphic 
I/O Control Routine to have the buffer 
restart address stored in the UCB 
associated with the display unit for 
which the routine builds a channel 
program. 

R15 contains no applicable 
information. 

R0 contains the buffer restart address 
to be stored in the UCB in the high 
order two bytes. The low order two 
bytes point to the UCB. 

Rl contains a zero 



SVC 85 (SWAP) 

Registers 15, 0, and 1 do not contain 
any applicable information. 



SVC 91 (VOLSTAT) 

R15 contains no applicable 

information. 

R0 when negative, contains the address 

of the UCB. Note: If device type is 

disk go to SVC 91 load 2. 

R0 when positive, contains the address 

of the DCB. 

Rl contents are as follows: 

if zero, the SVC was issued by 

CLOSE 

if X*32*, the SVC was issued by 

DDR 

if X f 33 f the SVC was issued by EOD 

if X^*, the SVC was issued by 

EOV 

if any other than the above, the 

SVC was issued by UNALLOCATION 



SVC 92 (TCBEXCP) 

R15 contains no applicable information 



R0 contains the address of the TCB for 
the issuers task. 



Rl contains the address of the IOB. 
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SVC 93 (TGET/TPUT) 

Entry from TGET 

R15 contains no applicable information 

RO the two high- order bytes are 
reserved- The two low-order bytes 
contain the buffer size in bytes. 

Rl contains a flag byte and an address 

as follows: 

the high order byte is a flag byte 
with these bit settings. 

1,. ....... Denotes "TGET" 

specified 

0....... Denotes "TPUT" 

specified 

. 1. ..... . Reserved. 

. . 1. ..... Reserved for TPUT 

. » . 1, . . . Denotes "NOWAIT" 

specified means that 
control should be 
returned to the 
program that issued 
the TGET whether or 
not an input line is 
available from the 
terminal if no input 
line is obtained , a 
return code of 4 will 
be found in register 
15. 

. . . 0. . . . Denotes "WAIT" 

specified means that 
control will not be 
returned to the 
program that issued 
the TGET until an 
input line has been 
put into the 
program's buffer if 
an input line is not 
available from the 
terminal, the issuing 
program is put into a 
wait state until a 
line does become 
available and is 
placed in the 
I program's buffer 

! , . ,. . 1. . . Reserved for TPUT 

I ...,.!.. Reserved for TPUT 
! ...... ..10 Reserved for TPUT 

01 Denotes "ASIS" 

specified means that 
normal or minimal 
editing will be 
performed. 

...... 00 Denotes "EDIT" 

specified means that 
in addition to the 
normal ("ASIS") 
editing, further 
editing will be 
performed. 



the low-order three bytes contain the 
address of the buffer that is to 
receive the input line. 

Entry from TPUT 

R15 contains no applicable 
information. 

R0 the two high-order bytes contain 
the Terminal Job Identifier number; 
the two low- order bytes contain the 
size of the input buffer in bytes. 

Rl contains a flag byte and an address 
as follows: 

the high- order byte is a flag 
byte with these bit settings: 
1 . ....... Denotes "TGET " 

specified 
0, ..... , Denotes "TPUT" 

specified 
.1...... Reserved 

... 1 . .. , , . Denct es "LOWP " 

specified means that 
the terminal will not 
receive any 
inter-terminal 
messages if TSBITOFF 
is on even if a 
key-zero task is 
sending the messages 
may only be specified 
on a TPUT with TJID. 
..0..... Denotes "HIGHP" 

specified means that 
the terminal will 
receive 

inter-terminal 
messages even if 
TSBITOFF is on if a 
key-zero task is 
sending the messages 
may only be specified 
on a TPUT with TJID. 

...1 Denotes "NOWAIT" 

specified means that 
control should be 
returned to the 
program that issued 
the TPUT whether or 
not system output 
buffers are available 
for the output line 
if no buffers are 
available, a return 
code of 4 will be 
found in register 15. 
... ... . Denotes "WAIT " 

specified means that 
control will not be 
returned to the 
program that issued 
the TPUT until the 
output line has been 
placed in a system 
output buffer if no 
buffers are 
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avai lable, the 
issuing program will 
be put into a wait 
state until buffers 
do become available 
and the output line 
is placed in them. 

1. .. Denotes "HOLD" 

specified means that 
the program that 
issued the TPUT 
cannot continue its 
processing until this 
output line has been 
either written to the 
terminal or deleted. 

0... Denotes "NOHOLD" 

specified means that 
control should be 
returned to the 
program that issued 
the TPUT as soon as 
the output line has 
been placed on the 
output queue. 

.1.. Denotes "BREAKIN" 

specified means that 
output has precedence 
over input; that is, 
if the user at the 
terminal is 
transmitting, he is 
interrupted, and this 
output line is sent 
any data that was 
received before the 
interruption is kept 
and displayed at the 
terminal following 
this output line. 

.0. . Denotes "NOBREAK" 

specified means that 
input has precedence 
over output; that is, 
the output message 
will be placed on the 
output queue to be 
printed at some 
future time when the 
terminal user is not 
entering a line. 

..10 Denotes "CONTROL" 

specified means that 
this line is composed 
of terminal control 
characters and will 
not print or move the 
carriage on the 
terminal. 

. . 01 Denotes "ASIS" 

specified; means that 
normal or minimal 
editing will be 
performed. 

. . 00 Denotes "EDIT" 

specified; means that 
in addition to the 
normal ("ASIS") 



editing, further 
editing will be 
pe rf ormed. 

the low-order three bytes contain the 
address of the buffer that is to hold 
the line of output. 

SVC 94 (TERMCTL) 

Entry from TCLEARQ : 

R15 contains no applicable 
information. 



R0 Contents: 




Bytes 

01 

1-3 


— Entry code 

— Reserved 


Rl Contents: 




Bytes 

80 


— "INPUT" sp 



00 — "OUTPUT" specified 
— Reserved 



1-3 

Entry from STBREAK : 

R15 contains no applicable 
information. 

R0 Contents: 



Bytes 



1-3 

Rl Contents: 

Bytes 


1-3 

Entry from STCOM : 



04 — Entry code 
— Reserved 



80 — "YES" specified 
00 — "NO" specified 
— Reserved 



R15 contains no applicable 
information. 



R0 Contents: 






Bytes 



1-3 


05 



— Entry code 

— Reserved 


Rl Contents: 






Bytes 



80 


— YES specif 



00 — NO specified 
1-3 — Reserved 

Entry from STTIMEOU : 

R15 contains no applicable 
information. 
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RO Contents: 






Bytes 



1-3 


06 — 
— 


Entry code 
Reserved 


Rl Contents: 






Bytes 


1-3 


80 — 

00 — 

— 


"YES" specified 
"NO" specified 
Reserved 


Entry from STCC: 





R15 contains no applicable 
information. 



Contents : 






Bytes 



1-3 


07 — 
— 


Entry code 
Reserved 


Contents : 






Bytes 



Flag ] 


byte as fol. 



1. ..... . first operand 

specified 
. 1. . . . , ,. ATTN specified 

..!....* LD specified 

. . . 1. . . .. CD specified 

00000000 no operands 
specified, 
retain 

previously-used 
characters. 
— Reserved 
hh — line delete control 
character. The 
hexadecimal 
representation of any 
EBCDIC character on the 
terminal keyboard except 
the new line (NL) and 
carriage return (CR) 
control characters, 
c — the character 
representation of any 
EBCDIC character on the 
terminal keyboard, 
hh — character delete 
control character. The 
hexadecimal 
representation of any 
EBCDIC character on the 
terminal keyboard except 
the new line (NL) and 
carriage return (CR) 
characters. 

c — the character 
representation of any 
EBCDIC character on the 
terminal keyboard. 



Entry from ST ATTN: 

R15 contains no applicable 
information. 

R0 Contents: 



Bytes 

1 
2 



08 — Entry code 
00 — Reserved 
hh — Lines byte. The 
number of consecutive 
lines of output that can 
be directed to the 
terminal before the 
keyboard will unlock. 
00 — Output line 
counting is not used, 
hh — Tens byte. The 
tens of seconds that can 
elapse before the 
keyboard will unlock. 
00 — Locked keyboard 
timing is not used. 



Rl Contents: 




Bytes 







Flag byte as follows: 
















specified 




00000000 no operands 




specified. 




results in a 




NOP instruction 


1-3 


hhhhhh — Character 




string address. 




000000 — no character 




string was specified. 



Entry from STAUTOLN : 

R15 contains no applicable informtion. 

R0 Contents 



Bytes 



1-3 



Rl Contents: 

Bytes 



1-3 



09 — Entry code 
hhhhhh — the address of 
a fullword containing the 
number to be assigned to 
the first line of 
terminal input. 



00 — Reserved 
hhhhhh — the address of 
a fullword containing the 
increment value used in 
assigning line numbers. 
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Entry from STSIZE ; 

R15 contains no applicable 
information. 



RO Contents: 

Bytes 


1,2 
3 



Rl Contents: 

Bytes 

0-2 

3 



0A — Entry code 

0000 — Reserved. 

hh — lines byte. The 

number of lines (depth) 

that can appear on the 

screen. 



000000 — Reserved 
hh — size byte. The 
logical line size (width) 
in characters of the 
terminal. 



Entry from GTSIZE, STAUTOCP, SPAUTOPT. 
RTAUTOPT 

R15 contains no applicable 
information. 

R0 Contents: 



Bytes 




1-3 



Entry codes as follows: 

0B — GTSIZE 
0C — STAUTOCP 
0D — SPAUTOPT 
0E — RTAUTOPT 
000000 — Reserved 



Rl Contents: 

No applicable information, will 
be zeroed. 

Entry from STCLEAR : 

R15 contains no applicable 
information. 

R0 Contents: 



Bytes 



1-3 

Rl Contents: 

Bytes 



1-3 



10 — Entry code 
000000 — Reserved 



00 — Reserved, 
hhhhhh — erasure 
character string address. 



Entry from TCABEND 

R15 contains no applicable 
information. 



R0 Contents: 

Bytes 



1-3 



00 — Entry code 
— Reserved 



Rl Contents: 

No applicable information will be 
zeroed. 

Entry from TS ABEND 

R15 contains no applicable 
information. 

R0 Contents: 



Bytes 



1-3 



OF — Entry code 
— Reserved 



Rl Contents: 

No applicable information will be 
zeroed. 



SVC 95 (TSIP) 



R15 contains no applicable 
information. 



R0 Contents: 

Bytes 
0,1 



2 
3 

Entry Code 
00 

01 



zero or Terminal Job 

Identifier (TJID) or not 

applicable. 

00 — Reserved 

Entry code as follows: 

Calling Routine 
Problem Program (TMP) 

Timer Second - Level 
Interruption Handler 



02 


TGET/TPUT 


03 


Region Control Task 


04 


Dequeue, TIOC (Attention, 
TS INPUT, TSOUTPUT), Timer 
SLIH, WTOR 


05 


Region Control Task 


06 


Enqueue 


07 


Dequeue 


08 


TSO Dispatcher 


09 


TSO Dispatcher 


0A 


TSO Dispatcher 


0B 


TSO Dispatcher 


OC 


Region Control Task (Quiesce) 
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OD 
OE 

OF 

10 

11 

12 

13 

14-18 



Region Control Task (Quiesce) 

Time Sharing Control Task 
(Swap) 

Time Sharing Control Task 
(Swap) 

Time Sharing Control Task 
(Swap) 

Time Sharing Control Task 
(Swap) 

Region Control Task (Restore) 

Region Control Task (Restore) 

Reserved 



Rl Contents: 

Bytes 

0,1,2,3 variable as follows: 

Entry Code Content 

00 Address of 8-character 
command name sign-bit: 

0-ended 
1-beginning 

01 not applicable 

02 Sign-bit: 

0- Input 
1-Output 

Bytes 3&4: 

Number of free buffers 

03-05 not applicable 

06 Estimated must complete time 

07-OC not applicable 

0D Number of FBQEs 

0E Byte 0: Swap Units 

Byte 1: Swap device code 
(0,4,8,c) 

Bytes 2S3: 

Swap size in 2K blocks 

OF-13 not applicable 

SVC 97 (TEST(TSO)) 

Entered from: 

Any module of the tested program, 
when used as a breakpoint 
handler. If used as a breakpoint 
handler the TCBTCP bit is 'l* in 
the current TCB and registers 15, 
0, and 1 contain no applicable 
information. 



Any module of the TSO Test 
Command Processor when used as a 
subroutine of TSO TEST. In this 
case the current TCBTCP bit is 
•0* and registers are as follows: 

R15 contains no applicable 
information. 

R0 Contents: 

Bytes 

Entry code as follows: 
40 — Set TCBTCP bit to 
■I' 

20 — Set TCBTCP bit to 
•0* 

10 — Alter TCBTRN field 
08 — Alter second word 
of RBOPSW field 
04 — Alter specific 
register in SVC 97' s SVRB 
register save area 
04 — Alter all registers 
in SVC 97 's SVRB register 
save area 
02 — Alter 

floating-point register 
in TCB save area 
01 — Set RB wait count 
to (zero). 
1-3 Address of target TCB,, 
PRB, or IRB 
Rl Contents: 

Register 1 contents are variable as 
follows: 

Bytes 
Entry code 0123 not applicable 

40 
entry code 0123 not applicable 

20 
entry code not applicable 

1,2,3 TCBTRN value 
entry code instruction length, 
08 completion code 

program mask 
08 

1,2,3 address of value for 
second word of 
RBOPSW field, 
entry code register number 

07 1,2,3 address of new value 
entry code x'FF' 

04 1,2,3 address of 64-byte 
value 
entry code floating-point 
02 1*2,3 register number 

address of new value 
for register 
entry code 0,1, not applicable 

01 2,3 



SVC 100 



SVC 100 is used by the SUBMIT, OUTPUT, 
OPERATOR, and CANCEL/ STATUS 
processors. 
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Contact your FE programming 
representative for information 
concerning the content of General 
Purpose Registers 15, 0, and 1 upon 
entry to SVC 100. 

SVC 101 (QTIP) 

SVC 101 is used only by the TSO 
sub-system and the MCP and provides an 
interface between them for 
inter-region communication and data 
movement . 

R15 Contents: 



Bytes 


1-3 



— zeroed, by entry 

code in R0 

hhhhhh — variable by 

entry code in R0 as 

follows: 

00 — not applicable 
03 — entry address of 
QTIP0030 within 
IEDAYAA 
04-OD — not applicable 
0E — (with savearea 
address in Rl) not 
applicable. (Without 
savearea address in 
Rl) entry address of 
QTIP014 within 
IEDAYOO 
OF- 11 — not applicable 
12-16 — entry address of 
IKJGGQT1, branch entry to 
QTIP SVC 

17 — address of TSB 
being logged off 

18 — (same as 12-16) 
19-1A — not applicable 

1C — entry address of 

QTIP0280 within 

IEDAYII 

ID — not applicable. 



Content : 










Bytes 













— 2 


:eroed. 




1-3 


hh — 


entry codes as 




follows 








00 


-- 


invokes 


IEDAYAA 




03 


-- 


invokes 


IEDAYAA 




04 


— 


invokes 


IEDAYHH 




05-09 


— 


invokes 


IEDAYII; 




0A 


— 


invokes 


IEDAYLL; 




0B-11 


— 


invokes 


IEDAYOO 




12-14 


— 


invokes 


IEDAYGP 




15-16 


— 


invokes 


IEDAYAA; 




17 


— 


invokes 


IKJGG088 




18 


— 


invokes 


IEDAYOO; 




19-1A 


— 


IEDAYZZ 


invoked 




1C 


— 


invokes 


IEDAYII 




ID 


— 


IEDAYGP 


invoked; 



Rl Content: 



Bytes 



1-3 



— zeroed. 

hhhhhh — variable by 

entry code in R0 as 

follows: 



00 — address of 
savearea within AVT 
03 — not applicable 
04-OD — address of 
savearea within AVT 

0E — (without entry 
address in R15; 
address of savearea in 
AVT) (with entry 
address in R15; not 
applicable) 
0F-11 — address of 
savearea within AVT 
12-16 — not applicable 

17 — zeroed; 
indicates no savearea 
is being passed 

18 — not applicable 
19-1 A — address of 
savearea within AVT 

1C — not applicable 
ID — address of 
savearea within 
TIOCRPT 



SVC 103 (XLATE) 

R15 contains no applicable 
information. 

R0 contains the length of the field to 
be translated. 

Rl Contents: 



Bytes 
hh 



1-3 



SVC 104 (TCAM) 



action byte as 
follows : 

80-translate from 
EBCIDIC to ASCII 
00-translate from 
ASCII to EBCDIC 



hhhhhh address of field to 
be translated 



R15 contains no applicable information 

R0 indicates the subroutine to be 
executed as follows: 
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Bytes 

0-3 00000001 IGC0010D entry 
point routine 

00000002 GTFIELDA decode 
routine 

00000003 STTNME operator 
command addressing 
routine 

00000004 IEDQCA02 scan 
routine 

Rl contains the address of the 
operator control work area 



SVC 10 5 (IMGLIB) 

R15 contains no applicable information 

R0 contains no applicable information 

Rl indicates actions to be taken as 
follows : 

Bytes 

0-3 00000000 construct a DCB 
and DEB for 
SYS1. IMGLIB 
hhhhhhhh delete DCB at this 
address and also 
the DEB pointed to 
by the DCB. 



SVC 109 



Type 3 and type 4 SVC routing routine. 

R15 contains an index value, converted 
to 3 digit EBCDIC number and appended 
to name IGC00. This routine is then 
called. 

R0/R1 contain no applicable 
information for SVC 109, contents are 
to be used by called routine IGX00. 



SVC 116 



Type 1 SVC routing routine. 

R15 contains an index value, used in 
binary form to index into a table to 
call other SVC routines. 

R0/R1 contain no applicable 
information for SVC 116, contents are 
to be used by called routines. 



SVC 117 



Type 2 SVC routing routine. 

R15 contains an index value, used in 
binary form to index into a table to 
call other SVC routines. 

R0/R1 contain no applicable 
information for SVC 117, contents are 
to be used by called routines. 
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SVC Comprehensive Trace Records Group 2 - 
Basic Fields Plus DDNAME Field 



Group 2 SVC comprehensive trace records add 
a DDNAME field to the fields composing the 
basic record. The format is: 

!********1 
cccccccc? 
N/A J 

******** 

asterisks indicate an error 
occurred while gathering the 
information. 

cccccccc 

the name of the associated DD 
statement. 

N/A 

indicates that the DD name could 
not be obtained for the following 
reasons: 

The DCB was not opened 

The DCB TIOT offset was outside 

the valid range 

The DEB TCB pointer was set to 

The TCB TIOT pointer was set to 



The DD name in the TIOT was not 

in EBCDIC notation 

Following are descriptions of register 15, 
0, and 1 content for the Group 2 SVCs. 

SVC 24 (DEVTYPE) 



R15 contains no applicable 
information. 

R0 contains the address of the output 
area or the two's compliment of the 
output area address. 

Rl contains the address of the DD 
name, or the two's compliment of the 
DD name address. 

When control returns from the DEVTYPE 
SVC routine, the output area will 
contain 8, 20, or 24 bytes of device 
data, depending on the value (+ or -) 
of R0 and Rl, and the device type 
associated with the DDNAME as follows. 



Output Area Size (Bytes) 
RPS-DA DA Non-DA 



R0 and Rl 

positive 

R0 negative 

and 

Rl positive 

R0 and Rl 

negative 



20 



20 



24 



20 



20 



20 



SVC 31 (FEOV) 



R15 and R0 contain no applicable 
information 



Rl contains the address of the DCB 



SVC 53 (RELEX) 



R15 contains no applicable information 



R0 contains the address of a parameter 
list which contains either: 



hhhhhhhh relative block or TTR 
MBBCCHHR actual address 



Rl contains the address of the DCB 



SVC 55 (EOV) 



R15 contains no applicable information 



R0 contains the IOB address if the 
following are true: 



DCBOFLAGS = ...1.... 

DCBMACRF = 

and R0 is not equal to x* 00001000* 



Rl contains the DCB address 

SVC 57 (FREEDBUF) 

R15 contains no applicable information 
R0 contains the address of the DECB 
Rl contains the address of the DCB 

SVC 58 (REQBUF/RELBUF) 

R15 contains no applicable information 

R0 contains the request count or 
release address 

Rl contains the DCB address 

SVC 69 (BSP) 

R15 and R0 contain no applicable 
information 

Rl contains the address of the DCB 



Section 3: Tracing Aids 181 



SVC Comprehensive Trace Records; Group 3 - 
Basic Fields Plus Parameter List Field 



Group 3 SVC comprehensive trace records add 
a parameter list field to the fields 
composing the basic record. The parameter 
list field displays all or a portion of the 
parameter list being passed to the SVC 
routine by the caller. The format is: 



!N/A 
hhhhhhhh hhhhhhhh hhhhhhhh 
******** ******** ******** 



••! 



N/A 



indicates that there is no 
applicable information 



hhhhhhhh hhhhhhhh ... 

parameter list display. Content 
and amount varies with the SVC 
being traced. 

******** ******** 

indicates that an error occurred 
while gathering the information. 

Following are descriptions of register 15, 
0, and 1 content, and PLIST content for the 
Group 3 SVCs. 

SVC 1 (WAIT) 

R15 contains no applicable information 

R0 contains the count of the events 
being waited on. If zero the wait is 
treated as a NOP. 

Rl if positive, contains the address 
of the ECB being waited on. If 
negative, contains the address of a 
list of ECBs, in two* s complement 
form. 

PLIST may contain up to 40 bytes of 
information. It consists of a list of 
ECB addresses up to a maximum of 10. 

SVC 4 (GETMAIN) 



R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
parameter list passed when the SVC was 
called. (If Rl is zero there is no 
parameter list and the PLIST field 
will not be present.) 

PLIST is ten bytes in length and 
breaks down as follows: 



Bytes 
0-3 



hhhhhhhh 



5-7 



a. 



b. 



c. 



For a single area 
request - the length 
requested. 

For a variable request 
- the address of a 
doubleword containing 
the minimum and 
maximum length 
requested as shown 
below: 

Bytes 

zero 

1,2,3 minimum length 

4 zero 

5,6,7 maximum length 

For a list request - 
the address of a list 
of GETMAIN length 
requests (1 word per 
request) the last word 
containing x^O' in 
byte 0. 



hh 



Hierarchy identifier 
(optional) 

hhhhhhhh 

a. For a single area 
request - the address 
of a word GETMAIN will 
initialize as the 
beginning allocated 
core area. 

b. For a variable area 
request - the address 
of a doubleword which 
GETMAIN will 
initialize with the 
address of the 
GETMAINed area and the 
actual length 
allocated. 

c. For a list area 
request - the address 
of a list of words 
which GETMAIN will 
initialize with the 
address of allocated 
areas . 



8 hh Flag byte as follows : 

00 unconditional single area 

request 
20 conditional single area 

request 
CO unconditional variable 

request 
E0 conditional variable 

request 
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80 unconditional list request 
A0 conditional list request 

9 hh Subpool identification 

SVC 5 (FREEMAIN) 

R15 and R0 contains no applicable 
information. 

Rl contains the address of the 
parameter list passed when the SVC was 
called. (If Rl is zero, no list 
passed, and PLIST will not appear.) 

PL 1ST is 10 bytes in length and breaks 
down as follows : 



Bytes 
0-3 



4-7 



a. For a single area request 
the length to be freed. 

b. For a list area request — 
the address of a list of 
FREEMAIN length requests 
(1 word per request), the 
list word containing x*80' 
in byte 0. 

a. For a single area request 
— the address of an area 
to be freed. 



b. For a list area request — 
the address of a list of 
addresses of the areas to 
be freed. 

8 hh Flag byte as follows: 

00 unconditional single area 

request 
20 conditional single area 

request 
80 unconditional list area 

request 
A0 conditional list area 

request 

9 hh Subpool identification. 

SVC 18 (BLDL/FIND - Type D) 

R15 contains no applicable 
information. 

R0 contains the address of the 
parameter list. 

Rl contains the address of the DCB and 
indicates the macro instruction that 
issued the SVC call; if Rl is positive 
— BLDL; if Rl is negative — FIND. 

PLIST 

The BLDL parameter list is 12 
bytes in length: 

Bytes 

0,1 the numbering entries 

2,3 entry length 



4-11 the hexadecimal representation 
of the member name for which 
the BLDL was issued. 



The FIND parameter list is 8 
bytes in length: 

Bytes 

0-7 the hexadecimal representation 
of the member name for which 
the FIND was issued. 

SVC 19.20.22.23 (OPEN. CLOSE. OP ENJ.TCLOSE) 

R15 and R0 contain no applicable data. 

Rl contains the address of the 
parameter list. 

PLIST is up to 40 bytes in length and 
consists of a series of 4-byte entries 
(up to 10). Each entry breaks down as 
follows: 



Bytes 

hh 



Option byte as shown 
below: 



Bits 



1... .... Last Entry indicator 

011 .... LEAVE 

001 .... REREAD 

100 REWIND 

010 .... IDLE 
000 DISP 

. 0000 INPUT 

. 1111 OUTPUT 

. 0011 INOUT 

. 0111 OUTIN 

. 0100 UPDAT 

. 0001 RDBACK 



1-3 hhhhhh 
SVC 35 (WTO/WTOR) 



DCB address 



R15 contains no applicable 
information. 

R0 contains console source ID. 

Rl contains the address of the 
parameter list being passed to the 
SVC. 

PLIST is 12 bytes in length for WTO 
and 20 bytes in length for WTOR. 

The PLIST field for WTO breaks down as 
follows: 



Bytes 




00 — indicates WTO 
parameter list. 
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1 hh — message length plus 

four. 
2„3 hhhh — MCS flag bytes; bit 
settings as follows: 

Byte 2 

1. - . .... Invalid entry 

. 1. ..... Message is to be 

queued to the console 
whose source ID is 
passed in Register 0. 

- . 1. • . . . the WTO is an 

immediate command 
response. 

. . . . 1- , - the WTO macro 

instruction is a reply 
to a WTOR macro 
instruction. 

.....1. Message should be 
broadcast to all 
active consoles. 

. . . . . . 1 Me ssage queued for 

hard copy only. 

....... 1 Message queued 

unconditionally to the 
console whose source 
ID is passed in 
register 0. 

Byte 3 

1... .... time is not appended 

to the message. 
Invalid entry 
message is not queued 
for hard copy 
invalid entry 



1111. ,. . 
1. . 



11 



4-11 



First eight bytes 
of message 



The PLIST field for WTOR breaks down 
as follows: 



Bytes 



1-3 

4-7 

8 
9 

10,11 

12-19 



hh — length of reply 

hhhhhh — address of 

reply buffer 

hhhhhhhh — address of 

reply ECB 

00 — zeroed 

hh — message length plus 

four 

hhhh — MCS flag bytes, 

see WTO PLIST 

first eight bytes of 

message. 



SVC 37 (SEGLD/SEGWT) 

R15 contains no applicable 
information. 

R0 if zero, entry was from SEGLD; 
non-zero indicates entry from SEGWT. 



Rl contains the address of the 
parameter list. 

PLIST is 12 bytes in length and breaks 
down as follows: 



Bytes 

0-3 

4-7 

8 
9-11 



hhhhhhhh branch instruction 

(to SVC 45) 

hhhhhhhh address of 

Ref erredrto Symbol 

hh "to" segment number 

hhhhhh Previous caller or 



SVC 39 (LABEL) 



R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST is 20 bytes in length and breaks 
down as follows: 



Bytes 

0-2 

3 

4-7 

8-11 

12,13 

14 

15 

16-19 

SVC 40 (Extract) 



C00004 — REWIND option 
C00006 — UNLOAD option 
hh relative UCB in TIOT 
to use for mounting 
purpos es . 

hhhhhhhh address of 8 
byte DDNAME for DD card 
that allocates devices 
for mounting tapes, 
hhhhhhhh — address of 
volume label set. 
hhhh — length of one 
volume label, 
hh — number of labels 
in volume label set 
hh — command byte of 
control CCW 
hhhhhhhh — address of 
the first 10 bytes of 
volume header label. 



R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST is 12 bytes in length and breaks 
down as follows: 

Bytes 






«.«. 


Reserved 


1-3 


hhhhhh 


address of list area in 
which the extracted 
information will be 
stored. 


4 


00 


Reserved 
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5-7 



(TOOOO EXTRACT will obtain 
information from the 
current TCB and/or its 
related control blocks. 

hhhhhh address of TCB from 

which EXTRACT is to get 
requested information. 

hh flags byte; indicates 
the fields to be 
extracted as follows: 

Bits 

1. ..... . address of the 

general register 

save area 
. 1. ..... address of floating 

point register save 

area 
. . 1. .... reserved 
. . . 1. ... address of end-of - 

task exit routine 
. . . . 1. . . limit priority 6 

dispatching priority 
.....1.. task completion code 

1. address of TIOT 

1 address of the 

command scheduler 

communication list 

in the CSCB 



hh TSO only flags byte; 
indicates the TSO 
fields to be extracted 
as follows: 



Bits 

1. address of time- 
sharing flags in TCB 

. 1. . . . . . address of protected 

storage control 
block 

. . 1. .... terminal job 

identifier for task 

... xxxxx reserved 



10,11 0000 
SVC 45 (OVLYBRCH) 



reserved 



R15 contains the address of the Entry 
Table entry which caused the SVC to be 
issued. 

R0 and Rl contain no applicable 
information. 

PLIST is 12 bytes in length and breaks 
down as follows: 

0-3 hhhhhhhh Branch (inst. to 

SVC 45) 
4-7 hhhhhhhh address of 

Ref erred- to- Symbol 
8 hh "to" segment number 
9-11 hhhhhh Previous caller or 



SVC 47 (STIMER) 

R15 contains no applicable information 
R0 contents: 



Bytes 




hh 



1-3 



hhhhhh 



STIMER option byte 
as follows : 
X'" 40* TOD option 
x"30* DINTVL option 
x'lO' BINTVL option 
x'OO* TUINTVL option 
exit address 



R15 contains the address of the time 
value 

PLIST is four or eight bytes in length 
depending on the option in force: 

a. For the DINTVL and TOD options 
PLIST is eight bytes in length 
and represents the time value. 

b. For the BINTVL and TUNINTVL 
options PLIST is 4 bytes in 
length and represents the time 
value. 



SVC 48 (DEQ) 



R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST is 16 bytes in length and breaks 
down as follows : 



Bytes 

hh 



1 hh 



00 



2 hh 



if set to x'FF" 
indicates the last 
element in the 
parameter list. 
Otherwise no 
meaning. 

the length of the 
minor name whose 
address is in bytes 
8, 9, 10 and 11 of 
this element, 
the length of the 
minor name is in the 
first byte of the 
minor name field 
whose address is in 
bytes 8, 9 f 10, and 
11 of this element 
(does not include 
length byte itself) . 
DEQ parameters byte 
as follows : 

Bit Settings 

...... . Exclusive request 

1 ...... . Shared request 

. ..... . MINOR name is known 

only to job step 
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. 1. . .... the scope of minor 

name is SYSTEM 

. . 1. .... Set must complete 
equal to SYSTEM 

. . • 1. . . . set must complete 
equal to STEP 

.....000 RET=NONE 

.....001 RET=HAVE 

.....010 RET=CHNGE 

.....011 RET=USE 

Ill RET=TEST 

....1... RELEASE 
3 hh return code field 
for codes returned 
to the issuer by DEQ 
4-7 hhhhhhhh address of major 
resource name 
(QNAME) 
8-11 hhhhhhhh address of minor 
resource name 
(RNAME) 
12-15 hhhhhhhh if the DEQ 

parameters byte bit 
4 (RELEASE) is set 
on this word 
contains the UCB 
address; otherwise 
the content of this 
word is 
unpredictable . 



SVC 56 (ENQ) 



R15 and R0 contain no applicable 
information 

Rl contains the address of the 
parameter list 

PLIST is 16 bytes in length and breaks 
down as follows: 



Bytes 

hh 



1 hh 



00 



2 hh 



if set to x'FF* 
indicate the last 
element in the 
parameter list. 
Otherwise no 
meaning. 

the length of the 
minor name whose 
address is in bytes 
8, 9, 10, and 11 of 
this element, 
the length of the 
minor name is in the 
first byte of the 
minor name field 
whose address is in 
bytes Jr 9, 10, and 
11 of this element 
(does not include 
length byte itself). 
ENQ parameters byte 
as follows: 

Bit Settings 

0. . . . . . . Exclusive request 

1. ..... . shared request 



. ..... . MINOR name is known 

only to job step 

.1...... the scope of minor 

name is SYSTEM 

..I,..,, set must complete 
equal to SYSTEM 

...1.... Set must complete 
equal to STEP 

.....000 RET=NONE 

001 RET=HAVE 

010 RET=CHNGE 

.....011 RET=USE 

-....111 RET=TEST 

....1... RESERVE 
3 hh return code field 
for codes returned 
to the issuer by ENQ 
4-7 hhhhhhhh address of major 
resource name 
(QNAME) 
8-11 hhhhhhhh address of minor 
resource name 
(RNAME) 
12-15 hhhhhhhh if the ENQ 

parameters byte bit 
4 (RESERVE) is set 
on f this word 
contains the UCB 
address; otherwise 
the content of this 
word is 
unpredictable. 

SVC 60 (STAE/STAI) 

R15 contains no applicable information 
R0 contents: 

00 — Create 

04 — Cancel 

08 — Overlay 

Rl contains the address of the 
parameter list. The high-order bit is 
set to one if the XCTL=YES parameter 
was coded. 

PLIST is eight bytes in length and 
breaks down as follows: 



Bytes 




1-3 



4-7 



flag byte as 

follows : 

x •80* for STAI 

process ing 

x • 20 • for STAE 

processing 

hhhhhh If zero, the 

• CAMCE:' operand is 
in effect; otherwise 
this is the address 
of the STAE/STAI 
exit routine. 

hhhhhhhh address of the exit 
routine parameter 
list; if zero no 
exit routine 
parameter list 
exists. 
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SVC 63 (CHKPT) 



R15 and RO contain no applicable info. 

Rl contents: 

a. the address of the parameter list 

b. Zero if a CANCEL request 

PL 1ST is eight bytes in length and 
breaks down as follows: 



Bytes 




1-3 



5-7 



00 check ID address 

provided via the second 
parameter of CHKPT 
macro instruction 

80 No check ID address 
provided 

hhhhhh address of checkpoint 
DCB 

00 check ID address not 
provided 

01 to lOcheck ID length 

provided via third 
parameter of the CHKPT 
macro instruction 

FF "S w specified as third 
parameter of CHKPT 
macro instruction; the 
system generated check 
ID is to be placed at 
the address specified 
in bytes 5-7 

hhhhhh address for storing 

system generated check 
ID or address of user 
provided check ID 



SVC 64 (RDJFCB) 

R15 and R0 contain no applicable 
information 

Rl contains the address of the 
parameter list 

PLIST is up to forty bytes in length 
and consists of a series of 4-byte 
entries containing the DCB address. 
The high-order byte has bit set to 
one to indicate the last entry. 

SVC 70 (GSERV) 

R15 and R0 contain no applicable 
information. 

Rl contents: 



Bytes 




1-3 



hh is a mask indicating 
which bits in the 
Graphic Control Byte 
(GCB) should be reset. 

hhhhhh the address of a 

fullword field that 
identifies the DCB 
related to the GCB in 
which bits are to be 
reset. 



PLIST is four bytes in length and 
displays the fullword pointed to by 
Rl. Byte is a unit index factor 
used to locate the DCB address in the 
DEB associated with the DCB. (The GCB 
to be reset is in the UCB) . 



SVC 73 (SPAR) 



R15 and R0 contain no applicable 
information 

Rl contains the address of the 
parameter list 

PLIST is up to 40 bytes in length and 
consists of a series of 4-byte 
entries. The first entry breaks down 
as follows: 



Bytes 




hh 



the priority specified 
for the attention 
routine by the SPAR 
macro instruction. 
Reserved 

the number of words in 
the parameter list. 
Each additional entry contains a GACB 
address as specified by the SPAR 
macro. 



1 
2,3 



hh 
hhhh 



SVC 74 (DAR) 



R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST is up to forty bytes in length, 
consisting of 4-byte entries. The 
first entry breaks down as follows: 



Bytes 

0,1 

2,3 



hh Reserved 
hh the number of words in 
the parameter list. 



Each additional entry contains a GACB 
address specified by the DAR macro. 



SVC 77 (ONLT) 



R15 contains the address of the UCB of 
the line for the terminal being 
tested. 

R0 contains the address of the first 
of five , 9 , s in the test request 
buffer for ONLT (five 'Vs* indicate a 
request for an online test) . 

Rl contains the address of the 
parameter list. 

PLIST is 14 bytes in length and breaks 
down as follows: 
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Bytes 
0-3 



4-7 



8-11 



12 



13 



hhhhhhhh 



hhhhhhhh 



hhhhhhhh 



hh 



•hh 



address of the ECB 
and the prefix of the 
request buffer, 
address of the 
GERMAIN parameters 
and terminal test 
pattern table, 
address of special 
line control 
characters 

00 means test is 
valid 

01 means test is 
invalid and not set 
up 

00 means no answer on 
dial line 

01 means answer on 
dial line 



SVC 80 (GJP/GFX) 



(The SVC 80 Processing Routine serves 
as a communication link between GJP 
routines and the GFX Task, and between 
the GFX task and ABEND Hook routine. ) 

R15 contains no applicable 
information. 

R0 contains the address of the 
parameter list. 

Rl contains the address of the console 
control table. 

PL 1ST is eight bytes in length and 
breaks down as follows: 



Bytes 
0-3 



cccc 



4-7 



hhhhhhhh 



indicates which 
routine passed to SVC 
80 as follows: 

PLOG — Log Off 

PBEG — Begin Job 

Processor 

ABDH ~ Abend Hook 

Routine 

IERR — Internal 

Error Routine 

NPRO — Initial 

Processor 

the 2250 unit address 
that indicates which 
graphic job processor 
is using the SVC 80 
routine. 



SVC 87 (DOM) 



R15 contains no applicable 
information. 

R0 the value (positive or negative) of 
R0 determines the content of Rl. 



Rl If R0 is not negative, Rl contains 
a message ID word (which is also 
displayed in the PLIST field) . 

If R0 is negative, Rl contains the 
address of a list of message ID words. 

PLIST is up to 40 bytes in length, 
consisting of 4-byte entries. Each 
entry is a message ID word. The last 
entry is identified by the bit in 
the high-order byte being set to 1. 

SVC 90 (XQMNGR) 

R15 and R0 contain no applicable 
information. 

Rl contains the address of the QMPA. 

PLIST is 36 bytes in length and 
contains the QMPA fields. The QMPA 
and its associated control blocks are 
described in the MVT Job Management 
PLM, Order No. GY28-6660. 

SVC 96 (ST AX) 

R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST is 20 bytes in length and breaks 
down as follows: 



address of user 

program to get 

control at attention 

interrupt. 

size of input buffer 

(max 4095) 

size of output 

buffer (max 4095) 

address of output 

buffer 

address of input 

buffer 

STAX option flag 

byte as follows: 

Bits 

1 Reserved 

0. . .... replace=YES 

1 replace=NO 

. 1 def er=YES 

..!.... def er=NO 
. . . llllReserved 

address of user 
parameters for user 
program. 



Bytes 
0-3 


hhhhhhhh 


4,5 


hhhh 


6,7 


hhhh 


8-11 


hhhhhhhh 


12-15 


hhhhhhhh 



16 



hh 



17-19 hhhhhh 
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SVC 99 (TSO Dynamic Allocation) 

R15 and RO contain no applicable 
inf ormat i on . 

Rl contains the address of the 
parameter list. 

PLIST is up to 40 bytes in length. 
Consult your FE programming 
representative for information 
concerning the data displayed in this 
field,. 

SVC 102 (TCAM) 

R15 and RO contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST is up to 12 bytes in length 
depending on the function and breaks 
down as follows: 



Bytes 

hh 



Action code byte for 
SVC 102 as follows: 



.1.. . 



.1. 



...1 



.1. 



.1. 



Flag issuing 
task not 
eligible for 
rollout 
Post rollout/ 
roll in ECB 
complete 
Post standard 
or TSO ECB 
complete 
Flag issuing 
task not 
eligible for 
swap 

Move data 
across 
partition 
boundary 
Enqueue 
element on 
disabled 
ready queue 
and post MCP 
ECB complete 
Flag issuing 
task eligible 
for swap 
Flag issuing 
task eligible 
for rollout 



1-3 hhhhhh varies by action code 
as follows : 

Action Code 

80,40,01 ECB address 

20,02,10 

08,04 Data Address 

4 hh varies by action code 
as follows: 

20 x^O*, last 
four bytes 

80.40., 01, 
08,04,02, 

10 x'00' 

reserved 

5-7 hhhhhh varies by action code 
as follows : 

Action Code 

20,02,10 TSO job ID 
address 

80.40.01, TCB address 
08,04 Target 

address (for 
enqueuing an 
element the 
target 
address is 
the address 
of the 
disabled 
ready queue 
in the TCAM 
AVT). 

8 hh varies with action code 
as follows: 

Action Code 

80,40,20,10,08, 
04,02,01 x'80*, last 
four bytes 

9-11 hhhhhh varies with action code 
as follows : 

Action Code 

80.40.01 DEB address 
08,04 Length 

address 

10.20.02 TCB address 
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SVC Comprehensive Trace Records; Group H 
Basic Fields Plus Variable Fields 



GTF Group 4 SVC comprehensive trace records 
have a variety of fields — differing from 
SVC to SVC — added to the fields composing 
the basic SVC record (Group 1). Format and 
content of the additional fields for each 
SVC are discussed in the following 
material. 

SVC (EXCP) 



Additional fields — DDNAME, DCB, DEB. 

Register 15, 0, and 1 content, and 
DDNAME DCB, and DEB format and content 
follow: 

R15 and R0 contain no applicable 
information. 

Rl contains the address of the I OB 
associated with this request. 

DDNAME cccccccc 
N/A 

See explanation of DDNAME field 
under Group 2. 

DCB hhhhhhhh 

address of the DCB associated with 
this I/O request. 

DEB hhhhhhhh 

address of the DEB associated with 
this I/O request. 



SVC 6 (LINK) 



1-3 hhhhhh If byte is 80; the 
address of the 
directory entry list. 

If byte is 00; the 
address of the entry 
point name. 

4 hh hierarchy ID as 

follows: 

00 — no hierarchy 

01 — hierarchy 

02 — hierarchy 1 

5 hhhhhh address of DCB or 

zero. 

NAME cccccccc 

is the entry point/directory 
entry (EP/DE) name of the module 
to be linked to or control 
transferred to. 



SVC 7 (XCTL) 



(Same as SVC 6) 
SVC 8 (LOAD) 



Additional fields — PLIST, NAME 

Register 15, 0, and 1 content, and 
PLIST and NAME format and content 
follow: 

R15 contains the address of the 
parameter list. 

R0 and Rl contain no applicable 
information. 

PLIST hhhhhhhh hhhhhhhh 

is eight bytes in length and 
breaks down as follows: 



Bytes 
hh 



flag byte as follows: 

80 DE form of macro 

instruction 

00 EP and EPLOC form 

of macro instruction 



Additional field ~ NAME 

R15 contains no applicable 
information. 

R0 Content: 

If byte contains x*00\, bytes 
1, 2, and 3 contain the address 
of the entry point name. 

If byte contains x'SO*, bytes 
1, 2, and 3 contain the address 
of the directory entry list. 



Rl Content: 

In LCS systems, byte contains 
the hierarchy ID as follows : 

00 — no hierarchy 

01 — hierarchy 

02 — hierarchy 1 

In systems without LCS byte 
contains no significant 
information. 

Bytes 1, 2, and 3 contain the DCB 
address or zero if the default 
for DCB was specified. 



NAME cccccccc 

is the entry point/directory 
entry name of the module to be 
loaded. 
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SVC 9 (Delete) 



Additional field — NAME 

R15 and Rl contain no applicable 
information. 

RO contains the address of the entry 
point name. 

NAME cccccccc 

is the entry point name of the 
module to be deleted. 



SVC 13 (ABEND) 



Additional field — CMP CODE 

R15 and RO contain no applicable 
information. 

Rl contains significant information 
only if SVC 13 was not called by the 
ABTERM routines. In this case Rl 
contains the following: 



Bytes 




hh Flag byte as follows: 

Bits 

1... DUMP option 

.1 STEP option 

..xx xxxx reserved 



1-3 hhhhhh ABEND completion code 

CMP CODE hhhhhhhh 

is the ABEND completion code if 
SVC 13 was called by the ABTERM 
routines. It is the content of 
the TCBCMP field of the current 
TCB at the time the SVC interrupt 
occurred. If ABEND recursion has 
occurred this field will contain 
the recursive completion code. 

SVC 1U (SPIE) 

Additional field — PICA 

R15 and RO contain no applicable 
information. 

Rl contains the address of the program 
interrupt control area (PICA) . 

PICA hhhhhhhh hhhh 

displays the program interrupt 
control area from the associated 
SPIE macro instruction. 

SVC 15 (ERREXCP) 



Additional fields — DDNAME, RQE, RQE 
TCB, CUU hhhh 

R15 and RO contain no applicable 
information. 



Rl contains the address of the Request 
Queue Element (RQE) which was assigned 
to this I/O request by IOS. 

DDNAME cccccccc 

is the name of the DD statement 
associated with this I/O request, 

RQE hhhhhhhh hhhhhhhh hhhhhhhh 

is the first 12 bytes of the RQE 
assigned to this request by IOS. 
The breakdown is : 

Bytes 

0,1 hhhh not applicable 
2,3 hhhh address of the UCB 
4 hh TCB ID for MFT 
5,6,7 hhhhhh address of IOB 

8 hh priority byte 

9 hhhhhh address of DEB 

RQE TCB hhhhhhhh 

is the address of the TCB 
associated with the I/O request. 

CUU hhhh 

device address in channel-unit 
form of the device associated 
with this I/O request. 

SVC 16 (PURGE) 

Additional fields — DDNAME, DCB, 
PLIST 

R15 and RO contain no applicable 
information. 

Rl address of the purge parameter 
list. 

(n/A J 
DDNAME j cccccccc \ 

cccccccc 

is the name of the DD statement 
associated with the requests 
being purged. 

DCB hhhhhhhh 

is the address of the DCB 
associated with the purge 
request. 

PLIST hhhhhhhh hhhhhhhh hhhhhhhh 

displays the PURGE parameter list 
which breaks down as follows: 



Bytes 
hh 



option byte as 
follows : 

Purge request 
elements in complete 
DEB chain starting 
with DEB specified in 
address field. 
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1... 
.1.. 

• .0. 

..1. 

... 

...1 



... Purge the requests 

associated with the 

DEB specified in 

address field. 
. . . Post the purge 

requests with x'UBV. 
. . . Allow the active 

request to quiesce. 
... Halt the I/O 

operations . 
... Purge all requests. 
... Purge only related 

requests. 
0. . Purge AEQ, RB and I OS 

logical channel 

queue. 
1. . Purge AEQ and I OS 

logical channel 

queue. 
.0. Purge by DEB 
.1. Purge by TCB 

address of DEB. 
completion code 
address of TCB 
quiesce indicator: 
01 if one or more 
requests are 
quiescing. 
9-13 hhhhhh address of IOB. 

SVC 17 (RESTORE) 

Additional fields — DDNAME-, DCB, DEB 

R15 and R0 contain no applicable 
information. 

Rl contains the address of a pointer 
to the 'chain of IOBs to be restarted. 



1-3 hhhhhh 

4 hh 

5-7 hhhhhh 

8 hh 



(N/A \ 

DDNAMe! cccccccc \ 
I********] 



cccccccc 

is the name of the DD statement 
associated with this IOB. 

DCB hhhhhhhh 

is the address of the DCB 
associated with the IOB. 

DEB hhhhhhhh 

is the address of the DEB 
associated with the IOB. 



Rl contains the address of the 
associated DCB. 

The values, positive or negative, of 
R0 and Rl, indicate the directory 
action STOW is to take as follows: 



R0 Rl 


Action 


+ + 


ADD 


+ - 


REPLACE 


- + 


DELETE 


- - 


CHANGE 




N/A 


DDNAME 


CCCCCCCC 




******** 



cccccccc is the name of the 
associated DD statement. 



PLIST 



hhhhhhhh 



• (2 or 4 words) 



SVC 21 (STOW) 



Additional fields — DDNAME, PLIST 

R15 contains no applicable 
information. 

R0 contains the address of the 
parameter list. 



is eight or 16 bytes in length, 
depending on the directory action 
being performed: 

For ADD, REPLACE, or DELETE 
actions the PLIST field is 
eight bytes long and 
contains, the member name or 
alias of the PDS directory 
entry being acted upon. 

For CHANGE the PLIST field 
is 16 bytes long, the first 
eight bytes containing the 
old member name or alias, 
and the second eight bytes 
contain the new member name 
or alias. 

SVC 25 (TRKBAI) 

Additional fields — DDNAME, DCBFDAD, 
DCBTRBAL 

R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
associated DCB. Note : If Rl is 
negative, the address is in complement 
form and the DCBFDAD and DCBTRBAL 
fields are meaningless. 

!N/A ) 
cccccccc / 

is the name of the associated DD 
statement. 

DCBFDAD hhhhhhhh hhhhhhhh 

is the full direct access address 
(MBBCCHHR) from the DCB pointed 
to by Rl. 
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DCBTRBAL hhhh 

is the track balance — the 
number of bytes remaining on the 
current track after a write. The 
field is negative if no bytes 
remain. 

SVC 26 (CATALOG/INDEX/LOCATE) 

Additional fields — PLIST, DSN 

R15 and RO contain no applicable 
information. 

Rl contains the address of the 
parameter list when CATALOG or INDEX 
issue the SVC call. 

Rl contains the address of CAMLST as 
generated by the CAMLST macro 
instruction when LOCATE issues the SVC 
call. 

DSN cccccccc . . . 

is the data set name. 



PLIST hhhhhhhh 



(4 words) 



is the parameter list passed to 
the SVC routine by the calling 
macro instruction. Its content 
varies, depending on the macro 
instruction issuing the call. 

Entry from CATALOG ; 

option byte as follows: 



Bytes 




hh 



Bits 

. . . ... 

...1 

1. . 



Search is to 
start on 
specified 
CVOL 

Search is to 
start on 
SYS. RES 
Catalog a 
data set 
Recatalog a 
data set 
Uncatalog a 
data set 



hh 



option bytes as follows; 



Bits 



..1. 



Build all 
missing index 
levels 
Delete all 
unneeded 
index levels 
except the 
high level 
Indicate 
presence of 
DSCB TIR 



2 
3 
4 
5-7 



8 
9-11 



12 
13-15 



00 
00 
00 



Reserved 



hhhhhh address of the area that 
contains the data set 
name 

00 Reserved 

hhhhhh the address of the CVOL 
ID, or zeroed. 



00 



hhhhhh address of the volume 
list 



Entry from INDEX : 



Bytes 




hh 



hh 



option byte as follows: 

Bits 

1... .... Search is to 

start on 

specified 

CVOL 
0. Search is to 

start on 

SYS. RES 

option byte as follows: 



Bits 




.1.. 




. .1. 


.... 


...1 


. . • • 


.... 


1. .. 




.1.. 



hh 



4 
5-7 



hh 



00 



Build an 

index 

Build a 

generation 

index 

Build an alias 

Connect CVOLs 

Delete an 

index 

Delete an 

alias 



option byte as follows: 

Bits 

1. • . .... Disconnect 

CVOLs 
.1 Indicate 

DELETE option 
.... 1. . . Indicate 

EMPTY option 

size of generation data 
group 



hhhhhh a. address of the index 
name, 
b. address of an eight 
byte area that 
contains a high-level 
index name. 
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c. address of an area 
that contains an 
alias to be deleted. 



00 



9-11 



12 



hhhhhh the address of the area 
that contains the CVOL 
ID, or zeroed. 



00 



13-15 hhhhh a. 



b. 



address of an 
eight-byte area that 
contains an alias for 
a high-level index, 
address of a ten-byte 
area that contains 
the 4- byte device 
code of the CVOL to 
be connected followed 
by its 6- byte volume 
serial number. 



Entry from LOCATE ; 



Bytes 













hh 


option byte as follows: 






Bits 










1... 




Search is to 
start on 
specified 
CVOL 






0... 


•"• * • 


Search is to 
start on 
SYS. RES 






.... 


..1. 


Read a block 
by TTR- 






..00 


0.0. 


LOCATE a name 



Option byte as follows: 

Bits 

.000 0000 LOCATE a name 

option byte as follows: 

Bits 



0... 



LOCATE a name 



1 hh 

2 hh 

3 00 

4 00 



5-7 hhhhhh address of the data set 
name or the relative 
track address (TTR) of 
the desired block in the 
catalog. 



00 



9-11 hhhhhh address of the CVOL ID 
or zeroes. 

12 00 



13-15, hhhhhh address of a 265 byte 
workarea which must be 
on a doubleword 
boundary. If the issuer 
of LOCATE has a non-zero 
protect key, then the 
workarea must have a 
matching storage protect 
key. 

SVC 27 (OBTAIN) 



Additional fields — PLIST, VOLSER, 
DSN/CCHHR 

R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST hhhhhhhh ... (4 words) 

displays the OBTAIN parameter 
list which breaks down as 
follows : 



Bytes 
0-3 



hhhhhhhh operation code as 
follows : 



C1000000 
C1800000 



4-7 hhhhhhhh 



8-11 hhhhhhhh 



12-15 hhhhhhhh 



SEARCH for DSNAME 
SEEK for track 
address 

address of data 
set name or 
address of track 
address of DSCB, 
CCHHR depending 
on operation 
code. 

address of the 
volume serial 
number 

address of 

14-byte 

workarea. 



[N/A 1 
VOLSER I cccccc I 



cccccc is the volume serial 
number of the associated volume. 

N/A indicates that the volser 
pointer in the parameter list was 
zero. 



I nnnnn 
DSN/CCHHR 1 cccccccccc 



nnnnn is the track address in 
EBCDIC notation and is displayed 
when the operation code in Word 1 
of the parameter list indicates 
SEEK. 
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cccccc ... is the data set name 
and is displayed when the 
operation code in word 1 of the 
parameter list indicates SEARCH. 
N/A if the name is unavailable. 



SVC 28 (OPENEXT) 



Additional fields — content of R13 

R15 contains no applicable 
information. 

RO contains zeroes, or the DCB address 
of the SYSCTLG to be processed. 

Rl contains the UCB address of the 
volume whose SYSTCLG is to be opened, 
if RO contains zeroes . 

SVC 29 (SCRATCH) 



Additional fields — PLIST, DSN 

R15 contains no applicable 
information. 

RO contains zeroes; or, the address of 
a UCB or a SUBUCB (for a 2321 device) 
for the device upon which unmounted 
volumes may be mounted. 

PLIST hhhhhhhh ... (4 words) 

displays the SCRATCH parameter 
list which breaks- down as 
follows : 

Bytes 

0-3 hhhhhhhh operation code 
as follows: 

41004000 — check 
purge date 
41005000 -- 
override purge 
date 



4-7 

8-11 
12-15 



hhhhhhhh address of data 
set name 

not used 

address of the 
volume list 



DSN ccccccccc . . . 

is the data set name, 
name is unavailable. 

SVC 30 (RENAME) 



N/A if the 



Additional fields — PLIST, OLD DSN, 
NEW DSN 

R15 contains no applicable 
information. 



R0 contains the address of the UCB for 
the device on which unmounted volumes 
should be mounted, or zero. 



Rl contains the address of the 
parameter list. 

PLIST hhhhhhhh ... (4 words) 

displays the RENAME parameter 
list which breaks -down as 
follows : 

Bytes 

0-3 x 1 41002000' 

5-7 hhhhhhhh address of old 

data set name 
8-11 hhhhhhhh address of new 
12-15 hhhhhhhh address of the 

volume list 

OLD DSN ccccc ... 

is the fully qualified name of 
the data set to be renamed. N/A 
if the name is unavailable. 

NEW DSN ccccc ... 

is the new name for the data set 
being renamed. N/A if the name 
is unavailable. 

SVC 32 (ALLOCATE) 

Additional fields — CUU, DSN 

R15 contains no applicable information 

R0 when positive, contains the address 
of the associated job file control 
block; when negative (not 
complemented — high-order bit is set 
on) , contains the address of the 
associated model DSCB. 

Rl contains the address of the UCB 
list. 

CUU ccc 

is the unit address from the UCB 
pointed to by Rl. 

DSN cccccccc ... 

is the data set name from the DSN 
field of the JFCB or DSCB pointed 
to by R0. N/A if the DSN field 
was blank. 

SVC 33 (IOHALT) 

Additional fields — CUU 

R15 and R0 contain no applicable 
information 

Rl contains the address of the UCB 
associated with the request to be 
halted. 
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CUU hhhh 

is the device address associated 
with the device being halted. 



SVC 41 (IDENTIFY) 



Additional fields — EPNAME 

R15 contains no applicable 
information. 

RO contains the entry point name 
address 

Rl contains the main storage address 
for the entry point name being added. 

EPNAME cccccccc 

is the entry point name being 
added. 

SVC 42 (ATTACH) 

Additional fields — SUPRVLIST, PPLIST 

R15 contains the address of the 
parameter list being passed to the SVC 
routine. 

RO contains no significant 
information. 

Rl contains the address of the 
parameter list being passed to the 
called program, or zero (no parameter 
list being passed). 

SUPRVLIST hhhhhhhh ... (36 bytes) 
is the parameter list being 
passed to the SVC routine and 
breaksdown as follows: 



Bytes 




1-3 



5-7 

8 

9-11 

12 



hh EP/DE flag byte: 

00 — EP or EPLOC 

specified 

80 — DE specified 
hhhhhh address of the EP 

name or directory 

entry (determined 

by byte 0). 
hh hierarchy flag 

(used if option 

chosen) : 

00 — no hierarchy 
specified 

01 — hierarchy 

02 — hierarchy 1 
hhhhhh address of the 

DCB; or zero, 
hh Reserved, 
hhhhhh address of the ECB 
hh GSP flag byte: 

00 — bytes 13-15 

contain subpool 

number 



13-15 hhhhhh 



16 



hh 



17-19 hhhhhh 



01 — bytes 13-15 

contain the 

address of a 

listing of subpool 

numbers . 

a subpool number 

or address of 

subpool list 

(determined by 

byte 12) 

SHSP flag byte: 

00 — bytes 17-19 
contain a subpool 
number 

01 — bytes 17-19 
contain the 
address of a list 
of subpool 
numbers . 

a subpool number 

or address of a 

subpool list 

(determined by 

byte 16) 

Roll- In/Roll-Out 

flag: 

00 — new task may 
not be rolled-out 
and cannot invoke 
roll- out. 

01 — new task may 
not be rolled- out 
but can invoke 
roll- out 

02 — new task may 
be rolled- out but 
cannot invoke 
roll- out 

03 — new task may 
be rolled- out and 
can invoke 

roll- out 



21-23 hhhhhh address of the 

end-of-task exit 
routine 



20 



hh 



24 , 25 hhhh 

26 hh 

27 hh 

Bits 
.0.. . 

.1.. . 



dispatching 
priority number 

limit priority 
number 

Key Flags byte as 
follows : 



Reserved 
Propagate the 
JSCB field from 
the originating 
task 

If the origina- 
ting task has a 
protect key of 
0, move the 
specified JSCB 
address into the 
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.,0. 






.1 



attached TCB; 
otherwise , 
propagate the 
originating 
task's TCBJSCB 
field 

Subpools 251 and 
252 and the job 
pack queue 
pointer of the 
originating task 
are not given 
to the attached 
task. 

Subpools 251 and 
252 of the job 
pack queue 
pointer are 
given to the 
attached task, 
the attached 
task is to have 
a protect key 
of 0. 

Subpool zero is 
to be shared 
with other 
tasks. 

Subpool zero is 
not to be 
shared 

A save area of 
72 bytes is to 
be obtained for 
the task. 
No save area is 
to be obtained. 
Propagate the 
TCBJSTCB field 
from the 
originating 
task. 

The TCBJSTCB of 
the new task is 
to point to the 
new task. 
. The new task is 
to operate in 
problem program 
mode. 
. 1 The new task is 
to operate in 
supervisor mode, 
the entry point 
name for EP; or 
blank for EPLOC or 
DE specification. 



PPL 1ST hhhhhhhh hhhhhhhh hhhhhhhh 

. . . (up to 40 bytes) 

is the parameter list being 
passed to the called program and 
consists of a series of four-byte 
entries, each entry having it's 
high-order byte reserved, and an 
address in the low- order three 
bytes. 



0. 



1. 



.0. 



.. .1 



0. 



.1 



28-35 hhhh 



SVC U4 (CHAP) 



Additional fields — CHAP TCB 

R15 contains no applicable 
information. 

R0 contains a signed value to be added 
to the dispatching priority of the 
specified task. A negative value will 
be in two's -complement form. 

Rl contains the address of an area 
containing the address of the TCB 
whose priority is to be changed; or 
zero. If zero, it indicates that the 
active task's priority is to be 
changed. 

CHAP TCB hhhhhhhh 

is the address of the TCB of the 
active task at the time the SVC 
interrupt occurred. 



SVC 51 (SNAP) 



Additional fields — PLIST, MODN 

R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST: 

The PLIST field when SVC 51 is 
called by the SNAP macro 
instruction is 12 bytes in length 
and breaksdown as follows : 

PLIST hhhhhhhh hhhhhhhh hhhhhhhh 
displays three words of the 
parameter list passed to SVC 
51 by SNAP. 



Bytes 

hh 

1 00 

2 hh 



ID number to be 
printed in the 
identification 
heading of the dump. 



option flag bytes as 
follows : 



Bits 



. . . .... 


ABEND request 


1... 


SNAP request 


.1.. 


TCB address given 


. . 1 . .... 


Display all 




supervisor data 


... 1 .... 


Display trace 




table 


• «•• J. • ■ « 


Display nucleus 


• ••• • X* a 


Snapshot list is 




given 
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hh 

Bits 

1. . .. 

0.. 
1.. 
• 1. 

..1 



. .1. ID given 
...1 Display QCBs 



option flag byte as 
follows: 



. Save area (see 

next flags) 
, Display entire 

save area 
. Di splay heading 

only 
.Display registers 
on entry to ABEND 
or SNAP 
. Display link pack 
area 
. 1... Display job pack 

area 
. .1.. Display PSW on 

entry to ABEND or 
SNAP 
. .. .1. Display all 

subpools less 
than subpool 128 
. . . . x Reserved 



00 



5-7 hhhhhh address of DCB 



00 



9-11 hhhhhh address of the TCB 
specified in the 
SNAP macro 
i ns truction ; or 
zero. If zero, the 
dump is for the 
current task. 

Certain calls for SVC 51 may result in 
a 16 byte PLIST field being recorded. 
If there is a problem in this area 
please contact your FE programming 
representative for programming 
support. 

|n/a 

MODNl cccccccc 

cccccccc is the name of the 
module calling SVC 51. 

N/A appears if no module name is 
available. 

SVC 54 (DISABLE) 



Additional fields — DDNAME, DCB, DEB 

R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
associated DCB 



(N/A \ 
cccccccc } 

is the name of the DD statement 
associated with this request. 

DCB hhhhhhhh 

is the address of the associated 
DCB. 

DEB hhhhhhhh 

is the address of the associated 
DEB. 

SVC 62 (DETACH) 

Additional fields — DETACH TCB 

R15 and R0 contain no applicable 
information. 

Rl contains the address of an area 
containing the address of the TCB to 
be detached. 

Note: If Rl contains zero the DETACH 
TCB field is meaningless. 

DETACH TCB hhhhhhhh 

is the address of the TCB to be 
detached . 

SVC 65 (QWAIT) 

Additional fields — R2 r QCB 

R15, R0 and Rl contain no applicable 
information. 

R2 contains the address of the QCB for 
the element being waited on. 

QCB hhhhhhhh hhhhhhhh hhhhhhhh 
is the queue control block 
pointed to by R2 r and breakdown 
as follows: 



Bytes 



1-3 



5-7 



8 
9-11 



hh queue status : 

01 — not on ready 
queue 

02 — not waiting 

03 — waiting 

hhhhhh address of first 
element on the 
queue. 

.hh priority of the 

queue when linked 
onto the ready 
queue. 

hhhhhh address of the next 
item on the ready 
queue. 

hh reserved. 

hhhhhh address of the STCB 
for the subtask to 
be activated. 



198 Programmer's Guide to Debugging (Release 21) 



SVC 66 (BTAM TEST) 

Additional fields — IOBERINF 

R15 and RO contain no applicable 
information. 

Rl contains the address of the I OB 
pointed to when the SVC was issued. 

IOBERINF hhhhhhhh ... (4 words) 

is the error information field 
used by BTAM error recovery 
routines. 

SVC 67 (QPOST) 

Additional fields — R2, QCB 

R15 and RO contain no applicable 
information. 

Rl contains the address of the element 
being posted. 

R2 contains the address of the QCB to 
which the element is being posted. 

QCB hhhhhhhh hhhhhhhh hhhhhhhh 
is the queue control block 
pointed to by R2 and breaksdown 
as follows: 



Bytes 
hh 



queue status: 

01 — not on Ready 
queue 

02 — not waiting 

03 — waiting 



1-3 hhhhhh address of first 
element on the 
queue. 

4 hh priority of the 

queue when linked 
onto the ready 
queue . 

5-7 hhhhhh address of the next 

7 item on the ready 
queue. 

8 hh reserved. 

9-11 hhhhhh address of the STCB 
for the subtask to 
be activated. 

SVC 71 (ASGNBFR/RLSEBFR/BUFINQ) 

Additional fields — DDNAME, PLIST 

R15 and RO contain no applicable 
information 

Rl contains the address of the 
parameter list. 

DDNAME cccccccc 

is the name of the DD statement 
associated with the DCB specified 
by the macro instruction.. 



PLIST hhhhhhhh hhhh ... (up to 12 

bytes) 

displays the parameter list 
pointed to by Rl. The content 
varies according to the macro 
instruction calling the SVC. 

Entry from ASGNBFR : 



Bytes 


1-3 
4-7 



04 request byte, 04 

indicates ASGNBFR 
hhhhhh the DCB address 
hhhhhhhh the address of a 
half-word field 
containing the 
number of bytes of 
buffer to be 
assigned. 



Entry from RLSEBFR : 



Bytes 




hh request byte: 
08 indicates 
RLSEBFR 
0C indicates 
RLSEBFR ALL 



1-3 hhhhhh the DCB address 
4-7 hhhhhhhh the address of a 
half-word field 
containing the 
number of bytes of 
buffer to be 
released. 



Entry from BUFINQ : 



Bytes 


1-3 
4-7 



8-11 



10 request byte, 10 
indicates BUFINQ 

hhhhhh the DCB address 

hhhhhh address of the 
table of buffer 
addresses (must be 
on a fullword 
boundary) 

hhhhhhhh the number of 

bytes specified to 
be available for 
the table of 
buffer addresses 



SVC 75 (Dequeue Routine) 

Additional fields — IQE 

R15 contains no applicable information 

R0 contains the address of the next 
IQE on the IRB active list for the 
attention routine when ATTNINQ has 
specified clear mode; otherwise, 
contains zero. 
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Rl Content: 



Bytes 




1-3 



N/A 



hh is a unit index to 
identify a 
particular 2260 
display station; or 
00 for a 2250 
station. 

hhhhhh the GACB address 



IQE hhhhhhhh hhhhhhhh hhhhhhhh 

when ATTNINQ specifies clear mode 
this field displays the first 3 
words of the IQE pointed to by 
R0: 



Bytes 
0-3 



4-7 
8-11 



hhhhhhhh the address of the 
next IQE in the 
chain, or zero 
hhhhhhhh not meaningful 
hhhhhhhh the address of the 
hhhhhhhh IRB associated 
with the IQE. 



N/A 
will appear in this field 
whenever the ATTNINQ macro 
instruction did not specify clear 
mode. 



Bytes 

0-3 hhhhhhhh address of the DCB 

4-7 hhhhhhhh EBCDIC character 

set image ID 
8 hh LOAD MODE 

indicator: 



. . . .... no fold 

. 1. . .... fold 

x.xx xxxx reserved 



hh 



10 



XXX. 



hh 



verification 
indicator: 

. . «, . verify 

.... don't verify 

xxxx reserved 

data check 
indicator: 



SVC 78 (LSPACE) 



Additional fields — CUU 

R15 and Rl contain no applicable 
information 

R0 contains the address of the 
associated UCB 

CUU hhhh is the unit address 



SVC 81. (SETPRT) 



Additional fields — DDNAME, PLIST 

R15 and R0 contain no applicable 
information 

Rl contains the address of the 
parameter list. 

DDNAME cccccccc 

is the name of the DD statement 
associated with the data set 
being printed. 

PLIST hhhhhhhh .. (four words) 

is four words of the parameter 
list being passed to SVC 81 and 
breaks down as follows: 



1... .... block 

.1 unblock 

00.. .... as DCB specifies 

.... 1... unfold UCS 3211 

.... .1.. fold UCS 3211 

..xx ..xx reserved 

11-14 hhhhhhhh EBCDIC FCB 
image ID 

15 hh FCB parameter 
options : 

1 . . . .... verify FCB 

1 align 

.xxx xxx. reserved 

SVC 82 (DISKANAL). Entered from modules: 

IEHDANAL, IEHOGETA, 
IEHDCELL, IEHDLABL,, 
IEHDREST, IEHDDUMP 

Additional fields — VOLSER, DA-ADDR, 
PLIST 

R15 and R0 contain no applicable 
information 

Rl contains the address of the 
parameter list. 

VOLSER CCCCCC 

is the volume serial number 

DA-ADDR N/A 

hhhhhhhh hhhhhhhh 

displays a six or eight byte 
track address or N/A, dependent 
on the options in effect for the 
SVC routine. The breakdown is: 

Option DA-ADDR Content 

analyze or format six- byte track 

address 
post UCB eight- byte trac 

address 
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address of 
alternate track 
CCHH 
unlabeled volume 

new volume 



N/A 



eight-byte 
track address 
N/A 



PLIST hhhhhhhh ... (16 bytes maximum) 
is either 8, 12, or 16 bytes of 
the parameter list pointed to by 
Rl. The first four bytes always 
consist of a flag byte, defining 
the function to be performed, and 
a 3-byte UCB address. The fifth, 
ninth, and thirteenth bytes, when 
present, will contain a flag 
indicating the last element 
(4-bytes) in the list. The 
breakdown is as follows: 



Bytes 

hh 



1-3 



hhhhhh 



(function 8F) 
4 80 



5-7 



hhhhhh 



(function IF) 
4 80 



5-7 



hhhhhh 



(function 00) 

4-70 hhhhhhhh 



8 80 
9-11 hhhhhh 



(function 08) 

4-7 hhhhhhhh 

8 80 

9-11 hhhhhh 



(function 88) 

4-7 hhhhhhhh 



function byte as 
follows : 

8F — new volume 

IF — address of 

alternate track 

CCHH 

00 — ANALYZE or 

FORMAT 

08 — POST UCB 

88 — unlabeled 

volume 

address of UCB 



flag byte — last 
element 
address of DCB 



flag byte — last 
element 
address of 
alternate track 
CCHH 



address of 

alternate track 

CCHH 

flag byte — last 

element 

address of 

alternate track 

information 



address of serial 

number 

flag byte -- last 

element 

address of VTOC 

address of VTOC 



address of serial 
number 



8-11 hhhhhhhh address of VTOC 
12 80 flag byte — last 

element 
13-15 hhhhhh address of DEB 



SVC 86 (ATLAS) 



Additional fields — PLIST, CCHHR 



R15 and R0 contain no applicable 
information 

Rl contains the address of the 
parameter list 

PLIST hhhhhhhh hhhhhhhh 

is the parameter list passed to 
SVC 86 and breaks down as 
follows ; 



Bytes 



hh flag byte as 
follows : 




1 User's channel 




program can not be 
re- executed. 




.xxx xxxx reserved 


1-3 


hhhhhh address of IOB 


4 


hh flag byte as 
follows: 



1... IEHATLAS is the 

calling program 

.1.. .... a partial count 

(CCHH only) has 
been passed by 
the calling 
program 

..1. .... a write special 
CCW is required 
for a track 
overflow record 

...1 .... a write 
special 
CCW is not 
required 

.... xxxx reserved 

5-7 hhhhhh address of count 

(CCHHR) or partial 
count (CCHH) field 

CCHHR hhhhhhhhhh 

is the five-byte track address of 
the complete (CCHHR) or partial 
count (CCHH) field passed by the 
calling program. 

Note: If entry to SVC 86 is from 
the IEHATLAS program (byte 4, bit 
in parameter list) this address 
points to the CCHH part of the 
count field. 
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SVC 88 (MOD 88) 

Additional fields — DEB, DSSTAT FLGS, 
DEVMOD 

R15 and RO contain no applicable 
information. 

Rl contains the address of the DCB 
associated with the current task at 
the time the SVC was issued. 

DEB hhhhhhhh 

is the address of the data extent 
block (taken from DCB pointed to 

by Rl) 

DSSTAT hh 

the data set status flags field 
(taken from the DEB) 

DEVMOD hh 

the device modifier field (taken 
from the DEB) 

SVC 89 (EMSERV) 

Additional fields — PLIST, RESMCW 

R15 and RO contain no applicable 
information 

Rl contains the address of the 
parameter list 

PLIST hhhhhhhh 

displays four bytes from the 
parameter list being passed to 
the SVC routine. The breakdown 
is: 



Bytes 
hh 



flag byte: 

CO — enter emulator 

mode 

AO — leave emulator 

mode 



1-3 hhhhhh address of control 
storage lead name 



RESMCW hhhhhhhh hhhhhhhh 

displays dight bytes of the 
RESMCW field from the RMS common 
area. 



SVC 98 (TSO PROTECT) 

Additional fields — PLIST, DSN 

R15 and RO contain no applicable 
information 

Rl contains the address of the 
parameter list 

PLIST hhhhhhhh 

displays the first four bytes of 
the parameter list as follows: 



Byte 

01 

02 

03 

04 



entry code for the 
add function 
entry code for the 
replace function 
entry code for the 
delete function 
entry code for the 
list function 



1-3 hhhhhh varies by function 
as follows : 

000000 ~- add 

function 

000000 — replace 

function 

000000 — delete 

function 

hhhhhh — 80 byte 

buffer address 

DSN cccccccc . . . 

is the data set name 
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IMDPRDMP OUTPUT COMMENTS - GTF PROCESSING 

The following comments may appear in the 
listing of GTF trace records. 

I/O ERROR ON ddname - CONTINUE 

Explanation : The EDIT function of 
IMDPRDMP is being used to process 
a GTF external trace data set. An 
I/O error was encountered while 
attempting to read the trace data 
set identified by ddname. Fewer 
than three consecutive I/O errors 
have occurred for this data set, 
so EDIT continues processing, 
ignoring the current block that 
caused the I/O error. 

I/O ERROR ON ddname - EDIT PROCESSING 
TERMINATED 

Explanation ; The EDIT function of 
IMDPRDMP is being used to process 
a GTF external trace data set. 
Three consecutive I/O errors have 
been encountered while attempting 
to read the trace data set 
identified by ddname. EDIT 
processing terminates. 

ERROR IN GTF BUFFER CHAIN 

Explanation : The EDIT function of 
IMDPRDMP is being used to process 
an internal (dump) trace data set. 
While attempting to locate the GTF 
trace buffers, IMDPRDMP 
encountered one of the following 
errors ; 

• A buffer pointer was not on a 
word boundary. 

• A buffer pointer addressed an 
area of main storage that 
could not be extracted from 
the dump for one of the 
following reasons: 

1. The pointer addressed an 
area higher than the 
highest address in the 
dump. 

2. IMDPRDMP encountered an 
I/O error while attempting 
to read the record 
containing the area 
addressed by the pointer. 

3. The block containing the 
addressed area was missing 
from the dump, perhaps 
because the program that 
produced the dump 
encountered an I/O error 
while attempting to write 
the block. EDIT 
processing is terminated. 



ERROR IN GTF BUFFER - CONTINUING WITH 
NEXT BUFFER 



Explanation : The EDIT function of 
IMDPRDMP is being used to process 
an internal (dump) trace data sat. 
EDIT has encountered a GTF trace 
record with a length that does not 
lie within the acceptable range of 
4 to 272 bytes. EDIT continues 
processing with the next GTF 
buffer. 



GTF NOT ACTIVE AT TIME OF DUMP 



Explanation : The Edit function of 
IMDPRDMP is being used to process 
an internal (dump) trace data set. 
EDIT has determined that GTF was 
not active at the time that the 
dump was taken. EDIT processing 
is terminated. 



TRACE RECORD LL INVALID, DD ddname BLOCK 
NO xxxyyy - EDIT PROCESSING TERMINATED 

Explanation : The EDIT function of 
IDMPRDMP is being used to process 
a GTF external trace data set. 
EDIT has encountered a GTF trace 
record with a length that does not 
lie within the acceptable range of 
4 to 272 bytes. Ddname identifies 
the GTF external data set being 
processed; xxxyyy identifies the 
number of the block containing the 
faulty record. EDIT processing is 
terminated. 

EDIT TERMINATED UPON USER'S REQUEST 

Explanation : A user exit has 
requested EDIT termination by 
returning to EDIT with a return 
code of 24. 

EXIT DELETED UPON USER'S REQUEST 

Explanati on : A user exit has 
requested that it no longer be 
invoked during the current EDIT 
execution. This is the result of 
a user exit routine return code of 
16 or 20. 

GTF OPTIONS IN EFFECT - option 

Explanation : The input trace data 
set was created by GTF with trace 
options in effect as indicated by 
* option* . The Service Aids 
publication describes the options 
available. 
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Appendix A: Debugging With an Operating System Dump 



The first facts you must determine in 
debugging with an operating system dump are 
the cause of the abnormal termination and 
whether it occurred in a system routine or 
a problem program. To aid you in making 
these determinations, ABEND, SNAP, and 
indicative dumps provide two vital pieces 
of information — the completion code and 
the active RB queue. Similar information 
can be obtained from a storage image dump 
or a stand-alone dump by analyzing PSWs and 
re-creating an active RB queue. 

A completion code is printed at the top 
of ABEND, SNAP, and indicative dumps. It 
consists of a system code and a user code. 
The system code is supplied by the control 
program and is printed as a 3-digit 
hexadecimal number. The user code is the 
code you supplied when you issued your own 
ABEND macro instruction; it is printed as a 
4-digit decimal number. If the dump shows 
a user code, the error is in your program, 
and the completion code should lead you 
directly to the source of error. Normally, 
however, a system code will be listed; this 
indicates that the operating system issued 
the ABEND. Often the system completion 
code gives enough information for you to 
determine the cause of the error. The 
explanations of system completion codes, 
along with a short explanation of the 
action to be taken by the programmer to 
correct the error, are contained in the 
publication IBM System/360 Operating 
System; Messages and Codes , GC28-6631. 



To locate the load module that had 
control at the time the dump was issued, 
find the RB associated with the module. If 
the dump resulted from an ABEND or SNAP 
macro instruction, the third most recent RB 
on the queue represents the load module 
that had control. The most recent and 
second most recent RBs represent the ABDUMP 
and ABEND routines, respectively. Storage 
image dumps and stand-alone dumps contain 
PSW information that can be used to 
identify the load module in control. 



Once you have located the RB or load 
module, look at its name. If it does not 
have a name, it is probably an SVRB for an 
SVC routine, such as one resulting from a 
LINK, ATTACH, XCTL or LOAD macro 
instruction. To find the SVC number, look 
at the last three digits of the resume PSW 
in the previous RB on the queue. If a 
previous RB does not exist, the RB in 
question is an SVRB for a routine invoked 



by an XCTL macro instruction. Register 15 
in the extended save area of the RB gives a 
pointer to a parameter list containing the 
name of the routine that issued the XCTL. 

If the RB does not bear the name of one 
of your load modules, either an RB was 
overlaid or termination occurred during 
execution of a system routine. The first 
three characters of the name identify the 
system component; Appendix C contains a 
list of component names to aid you in 
determining which load module was being 
executed. 

If the RB bears the name of one of your 
load modules, you can be reasonably certain 
that the source of the abnormal termination 
lies in your object code. However,, an 
access method routine may be at fault. 
This possibility arises because your 
program branches to access method routines 
through a supervisor-assisted linkage, 
instead of invoking them. Thus, an access 
method routine is not represented on the 
active RB queue. To ascertain whether an 
access method routine was the source of the 
abnormal termination, you must examine the 
resume PSW field in the RB. If the last 3 
bytes in this field point to a main storage 
address outside your program, check the 
load list to see if an access method 
routine is loaded at that address. If it 
is, you can assume that it, and not your 
program, was the source of abnormal 
termination. 

Abnormal Termination in System Routines ; 
By analyzing the RB* s name field or the SVC 
number in the previous RB, you can 
determine which system load module 
requested the termination. If the RB has a 
system module name, the first three 
characters tell you the name of the system 
component. The remaining characters in the 
name identify the load module in error. 

Remember, although a system routine had 
control when the dump was taken, a problem 
program error may indirectly have been at 
fault. Such a situation might result from 
an incorrectly specified macro instruction, 
an FQE modified inadvertently, a request 
for too much storage space, a branch to an 
invalid storage address, etc. To determine 
the function of the load module that had 
control, consult Appendix C. With its 
function in mind, the completion code 
together with an examination of the trace 
table may help you to uncover which 
instruction in the problem program 
incorrectly requested a system function. 
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Program Check Interruptions in Problem 
Programs : If you have determined from the 
completion code or PSWs and evaluation of 
the RB queue that the dump resulted from a 
program check in your problem program, 
examine the status of your program in main 
storage. (If you have received only an 
indicative dump, you must obtain either an 
ABEND/ SNAP dump or a stand-alone dump at 
this point. ) Locate your program using 
pointers in the RB. If its entry point 
does not coincide with the lower boundary 
of the program, you can find the lower 
boundary by adding 32(20) to the address of 
the RB (systems with MFT). The RB's size 
field gives the number of doublewords 
occupied by the RB, the program* and 
associated supervisor work areas. 
ABEND/ SNAP dumps with MFT have the storage 
boundaries of the problem program 
calculated and printed. 

Next, locate the area within your 
program that was executed immediately prior 
to the dump. To do this, you must examine 
the program check old PSW. Pertinent 
information in this PSW includes: 

Bits 12-15: AMWP bits 

Bits 32,33: Instruction length in 
ha If words. 

Bits 40-63: Instruction address 



A useful item of information in the PSW 
is the P bit of the AMWP bits (bits 12-15). 
If the P bit is on, the PSW was stored 
while the CPU was operating in the problem 
program state. If it is off, the CPU was 
operating in the supervisor state. 

Find the last instruction executed 
before the dump was taken by subtracting 
the instruction length from the instruction 
address. This gives you the address of the 
instruction that caused the termination. 
If the source program was written in a 
higher level language, you must evaluate 
the instructions that precede and follow 
the instruction at fault to determine their 
function. You can then relate the function 
to a statement in the source program. 

Other Interruptions in Problem Programs : 
If the completion code or PSWs and the 
active RB queue indicate a machine check 
interruption, a hardware error has 
occurred. Call your IBM Field Engineering 
representative and show him the dump. 

If an external interruption is 
indicated, with no other type of 
interruption, the dump probably was taken 
by the operator. Check with him to find 
out why the dump was taken at this point. 
The most likely reasons are an unexpected 



wait or a program loop. If a trace table 
exists, examine it for the events preceding 
the trouble or, if the trace table was made 
ineffectual by a program loop, resubmit the 
job and take a dump at an earlier point in 
the program. 



The remaining causes of a dump are an 
error during either execution of an SVC or 
an I/O interruption. In either case, 
examine the trace table. Entries in the 
table tell you what events occurred leading 
up to termination. From the sequence of 
events, you should be able to determine 
what caused a dump to be taken, From here, 
you can turn to system control blocks and 
save areas to get specific information. 
For example, you can find the sense 
information issued as a result of a unit 
check in the UCB, a list of the open data 
sets from the DEB chain, the CCW list from 
the IOB, the reason for an I/O interrupt in 
the status portion of the CSW, etc. 



Specialized Program Checks 

In addition to the error program checks 
(1-15), other system events cause program 
checks which are normally transparent to 
the user. They could,, however, if seen in 
a dump (except ABEND dumps where they do 
not appear, result in some confusion. One 
such event is the monitor call interrupt . 
On 360 CPU's, the monitor call appears as a 
01 (operation) interrupt code in the 
program old PSW. To verify that a 
simulated monitor call occurred, check the 
address in the program old PSW. A monitor 
call occurred if: 



1. The address (-4) points to an 
execution instruction ("44'); 

2. The execute is operating on an x'AFOO' 
in low core; 

3. A NOP (x'470») follows the execute. 

370 CPU's support the real monitor call 
interrupt. The code in the program old PSW 
is a x'40', and the PSW address (-4) points 
directly at an x'AF* instruction. 

On 360 CPU's, the x'AF* opcode is simulated 
as follows: 

1. The first time an x'AF* instruction is 
encountered, an execute instruction is 
substituted for the x'AF*. 

2. The execute is of an instruction in a 
low-core table (Class Mask Table). 

3. If the monitor call should occur, the 
instruction in the Class Mask Table is 
an x'AFOO'; if it should not occur, 
the instruction is a x'0700' (NOP). 
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4. Required class and ID information for 
the monitor call are contained in the 
x* 470* NOP following the execute. 

On 370 CPU's, the monitor call occurs under 
control of a mask in Control Register 8. 

The Generalized Trace Facility (GTF) is a 
user of the monitor call interrupt. For 
more detailed information, refer to the 
Service Aids Logic PLM , GY28-6721. 



Debugging Procedure Summary 



1. Look at the completion code or PSW 
printouts to find out what type of 
error occurred. Common completion 
codes and causes are explained in 
Appendix C. 

2. Check the name of the load module that 
had control at the time the dump was 
taken by looking at the active RB's. 

3- If the name identifies a system 

routine, proceed to step 4. If the 
name identifies a problem program and 
the completion code or PSW indicates a 
program check, proceed to step 6. If 
the name identifies a problem program, 
and the completion code or PSW 
indicates other than a program check, 
proceed to step 10. 

4. Find the function of the system 
routine using Appendix D. 

5. If the dump contains a trace table, 
begin at the most recent entry and 



proceed backward to locate the most 
recent SVC entry indicating the 
problem state. From this entry, 
proceed forward in the table, 
examining each entry for an error that 
could have caused the system routine 
to be terminated. 



6. If the name identifies one of your 
load modules, check the instruction 
address and the load list to see if an 
access method routine last had 
control. If so, return to step 4. 



7. Locate your program in the dump. 

8- Locate the last instruction executed 
before the dump. 

9. Examine the instruction and, if the 
program was written in a high-level 
language, the instructions around it 
for a possible error in object code. 

10. If a machine check interruption is 
indicated, call your IBM Field 
Engineering representative. 

11. If only an external interruption is 
indicated, ask the operator why he 
took the dump. Resubmit the job and 
take a dump at the point where trouble 
first occurred. 

12. Examine the trace table, if one is 
present, for events leading up to the 
termination. Use trace table entries 
and/ or information in system control 
blocks and save areas to isolate the 
cause of the error. 
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Appendix B: SVCs 



Register contents at entry to an SVC routine are often helpful in 
finding pointers and control information,. The table below lists SVC 
numbers in decimal and hexadecimal, and gives the type, associated macro 
instruction, and significant contents of registers and 1 at entry to 
each SVC routine. 



| Decimal 
| No. 

^ 

1 o 


Hex. 
No. 





Type 


I 


Macro 
^ 

EXCP 


1 o 





I 


XDAP 


1 1 


1 


I 


WAIT 


1 1 


1 


I 


WAITR 


1 1 


1 


I 


PRTOV 


1 2 


2 


I 


POST 


1 3 


3 


I 


EXIT 


1 4 


4 


I 


GETMAIN 


1 5 


5 


I 


PREEMAIN 


1 6 


6 


II 


LINK 


1 7 


7 


II 


XCTL 


1 8 


8 


II 


LOAD 


1 9 


9 


I, II 


DELETE 


| 10 
| 10 


A 

A 


I 
I 


GETMAIN or 
FREEMAIN 

(R Operand) 
FREEPOOL 


| 11 


B 


I, III 


TIME 


| 12 


C 


II 


SYNCH 


1 13 


D 


IV 


ABEND 


| 14 


E 


II, III 


SPIE 


1 15 


F 


I 


ERREXCP 



Register 




| Register 1 

I, , , , , 






_.j. _, — 

| IOB address 


Event count 




JECB address 


Event count 




|2's complement of 
|ECB address 


Completion code 




|ECB address 

| Parameter list address 
j Parameter list address 
j Parameter list address 
| Parameter list address 


Address of entry point 
address 


|DCB address 


Address of program name 




Subpool number (byte 
Length (bytes 1-3) 


0) 


j Address of area to 
j be freed 

j Time units code 

j Completion code 

|PICA address 

j Address of request queue 
(element 
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r - - i 

| Decimal 


T 

Hex. j 


| No. 
1 16 


No. | 
+ 

10 | 


1 17 


11 | 


| 18 


12 | 


| 18 


12 | 


1 19 


13 | 


| 20 


14. | 


j 21 


15 | 


| 22 


16 | 


| 23 


17 | 


1 24 


18 | 


1 25 


19 | 


1 26 


1A | 


| 26 


1A | 


1 26 


1A | 


1 27 j 


IB | 


I 28 


1C | 


I 29 


ID | 


| 30 


IE | 


1 31 


IF | 


I 32 


20 | 


| 33 


21 I 


1 34 


22 | 


| 35 


23 | 


| 35 


23 | 


| 36 


24 | 


| 37 


25 | 


| 37 


25 | 


| 38 


26 | 


| 39 


27 | 






Type j Macro 
III j PURGE 


III 


RESTORE 


II 


BLDL 


II 


| FIND 


IV 


lOPEN 



IV 

III 

IV 
IV 



CLOSE 

STOW 

OPEN TYPE=J 

CLOSE TYPE=T 



III 


DEVTYPE 


III 


TRKBAL 


IV 


CATALOG 


IV 


INDEX 


III 


LOCATE 


III 


OBTAIN 


IV 


CVOL 


IV 


SCRATCH 


IV 


RENAME 


IV 


FEOV 


IV 


ALLOC 


III 


IOHALT 


IV 


MGCR (MAST 




CMD EXCP) 


IV 


WTO 


IV 


WTOR 


IV 


WTL 


II 


SEGLD 


II 


SEGWT 


II 


TTROUTER 


III, IV 


LABEL 



Register 



Address of build list 



Parameter list address 



UCB address 
UCB address 



Register 1 

IOB chain address 
DCB address 



Address of parameter list 
of DCB addresses 

Address of parameter list 
of DCB addresses 

DCB address 

Address of parameter list 
of DCB addresses 

Address of parameter list 
of DCB addresses 

ddname address 

DCB address 

Parameter list address 

Parameter list address 

Parameter list address 

Parameter list address 



Parameter list address 
Parameter list address 
DCB address 
Address of UCB list 
UCB address 

Message address 
Message address 
Address of message 
Segment name address 
Segment name address 

Parameter list address 

(Part 2 of 5) 
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j Decimal 
| No. 


Hex. 
No. 


Type 


Macro 


Register 


Register 1 

I _ 


r ~ 1 
| 40 


r 1 
28 


n~ 1 
I, II, 
III , 


EXTRACT 


11 ' " 


Parameter list address 


| 41 


29 


II, III 


IDENTIFY 


Entry point name address 


Entry point address 


| 42 


2A 


II, III 


ATTACH 






| 43 


2B 


ii; in 


CIRB 


Entry point address 


Size of work area in 
doublewords 


| 44 
| 45 


2C 
2D 


I 
II 


CHAP 
OVLYBRCH 


+ Increase priority 
- Decrease priority 


TCB address 


| 46 


2E 


I 


TTIMER 




1 : Cancel 


| 47 


2F 


II 


STIMER 


Exit address 


Timer interval address 


| 48 


30 


I, II 


DEQ 




QCB address 


| 49 


31 


in 


TEST 






| 50 


32 










1 51 


33 


IV 


SNAP 




Parameter list address 


| 52 


34 


IV 


RESTART 




DCB address 


| 53 


35 


in 


RELEX 


Key address 


DCB address 


| 54 


36 


ii 


DISABLE 






| 55 


37 


IV 


EOV 


EOB address 


DCB address 


1 56 


38 


I, II 


ENQ 


QEL address 


QCB address 


1 56 


38 


I, II 


RESERVE 






1 57 


39 


III 


FREEDBUF 


DECB address 


DCB address 


1 58 


3A 


I 


RELBUF 




DCB address 


1 58 


3A 


I I 


REQBUF 




DCB address 


1 59 


3B 


III 


OLTEP 






1 60 
1 61 


3C 
3D 


III I 
III 


STAE 
TTSAV 


Create SCB 
4 Cancel SCB 
8 


Parameter list address 
Parameter list address 


| 62 


3E 


11 


DETACH 




TCB address 


| 63 


3F 


IV i 


CHKPT 




DCB address 


| 64 


40 


III , 


RDJFCB 




Address of parameter list 
of DCB addresses 


| 65 


41 


II 


QWAIT 




Parameter list address 


| 66 


42 


iv i 


BTAMTEST 







(Part 3 of 5) 



Appendix B: SVCs 211 



■T ■ — T" 



j Decimal 
| No. 


Hex. 
No. 


Type 


Macro 


Register 


Register 1 j 


j. 

1 67 




43 


II 


ENDREADY 




QPOST | 


| 68 


44 


IV 


SYNADAF 


Same as register on 
entry to SYNAD 


Same as register 1 on | 
entry to SYNAD j 


1 68 


44 


IV 


SYNADRLS 






| 69 


45 


III 


BSP 




DCB address | 


1 70 


46 


II 


GSERV 




Parameter list address j 


1 71 


47 


III 


RLSEBFR 




Parameter list address j 


1 71 


47 


III 


ASGNBFR 




Parameter list address j 


1 71 | 


47 j 


III 


BUFINQ 




Parameter list address j 


1 72 | 


48 


IV 


CHATR 




Parameter list address j 


1 73 | 


49 j 


III 


SPAR 




Parameter list address j 


1 74 | 


4A | 


III 


DAR 




Parameter list address j 


1 75 | 


4B 


III 


DQUEUE 




Parameter list address j 


1 76 | 


4C | 


IV 


IFBSTAT 






1 77 | 


4D | 


IV 


QTAMTEST 






1 78 | 


4E | 


III 


WSCAN 






1 79 | 


4F | 


I 


STATUS 






1 80 | 


50 | 


III 


IKASVC 






1 81 | 


51 | 


IV 


SETPRT 






1 82 | 


52 | 


IV 


DASDR 






1 83 | 


53 | 


III 


SMFWTM 




Message address j 


1 84 | 


54 ! 


I 


GRAPHICS 


DCB address and buffer 
restart address 




1 85 | 


55 | 


IV 


DDRSWAP 






1 86 | 


56 | 


IV 


ATLAS 




Parameter list address j 


1 87 | 


57 | 


III 


DOM 


If zero 

If negative 


A DOM message I.D. | 
A pointer to a list of DOM| 
message I. Ds j 


i 88 | 


58 | 


III 


MOD 8 8 


Routine code 


DCB address j 


1 89 | 


59 | 


III 


EMSRV 




Parameter list address j 


1 90 j 


5A | 


IV 


XQMNGR 


Address of list of 
ECB/IOB pointers 
(optional) 


QMPA address j 


1 91 | 


5B | 


III 


VOLSTAT 


DCB address 


zero: issued by CLOSE j 
Non-zero: issued by EOV j 

L_ J 
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r — i 
| Decimal 


r — — t 
Hex. | 


| No. 


No. | 


1- H 

| 92 


K 4 

5C j 


| 93 


5D | 


| 94 


5E | 


1 95 


5F | 


| 96 


60 | 


| 97 


61 | 


| 98 


62 | 


| 99 


63 | 


| 100 


64 | 


| 101 


65 | 


102 


66 | 


10 3 


67 | 


104 


68 | 


105 


69 | 


109 


6D | 


116 


74 | 


117 


75 | 






Type 

I 

IV 

IV 

I 

III 
III 

IV 
IV 

III 

I 
I 

IV 

III 

IV 

I 
II 



Macro 

TCBEXCP 
TGET/TPUT 

STERMINAL 
STATUS 

TSEVENT 

STAX 

TEST-TSO 

PROTECT 

none 

FIB 

QTIP 

AQCTL 

XLATE 

TOPCTL 

IMAGLIB 

AT 



Register 



TJID 6 buffer Size 
Entry code 

TJID/Entry Code or 



Entry code 

Field length 
Subroutine indicator 



Register 1 



Address of User's Buffer 

Not Always Applicable 
Parameter List Address 

Parameter List Address 



Parameter List Address 

Parameter List Address 

Action byte and field 
address 

Address of operator 
control word area 



Action indication 

— contents used by called routine — 

— contents used by called routines — 

— contents used by called routines — 
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Appendix C: Completion Codes 



Completion codes issued by operating system 
routines are often caused by problem 
program errors. This appendix includes the 
most common system completion codes, their 
probable causes, and how to correct the 
error or locate related information using a 
dump. For a more comprehensive coverage of 
completion codes, see the publication 
Messages and Codes . 



If a trace table exists (trace option 
was specified at system generation), 
the instruction address in the new 
program check PSW, location 104(68), 
contains the address of a field of 
register contents. This field 
includes registers 10 through 9 on an 
ABEND/SNAP dump, or 10 through 1 on a 
stand-alone dump. 



OCx A program check occurred without a 
recovery routine. If bit 15 of the 
old program PSW (PSW at entry to 
ABEND) is on, the problem program had 
control when the interruption 
occurred; "x" reflects the type of 
error that causes the interruption: 

x Cause 

1 Operation 

2 Privileged operation 

3 Execute 

4 Protection 

5 Addressing 

6 Specification 

7 Data 

8 Fixed-point overflow 

9 Fixed-point divide 
A Decimal overflow 

B Decimal divide 

C Exponent overflow 

D Exponent underflow 

E Significance 

F Floating-point 

The correct register contents are 
reflected under the heading "REGS AT 
ENTRY TO ABEND" in an ABEND/SNAP dump. 
In a stand-alone dump, register 
contents can be found in the register 
save area for ABEND'S SVRB. 

0F1 A program check occurred in the 

interruption handling part of the 
input/ out put supervisor. The 
applicable program check PSW can be 
found at location 40(28). (In systems 
with MFT,, this PSW is valid only if 
the first four digits are 0004). 

The problem program can be responsible 
for this code if: 

1. An access method routine in the 
problem program storage area has 
been overlaid. 

2. An IOB, DCB, or DEB has been 
modified after an EXCP has been 
issued,, but prior to the 
completion of an event. 



If no trace table exists, the above 
field contains registers 10 through 1 
on both ABEND/SNAP (MFT only) and 
stand-alone dumps. 



0F2 Most frequently caused by incorrect 
parameters passed to a type I SVC 
routine. 

100 A device has been taken off-line 
without informing the system, or a 
device is not operational. 

If a trace table exists, the most 
current entry is an SIO entry 
beginning with 30. The last 3 digits 
of the first word give the device 
address. 

If a trace table does not exist, 
register 1 (in the SVRB for the ABEND 
routine) contains a pointer to the IOB 
associated with the device. 

101 The wait count, contained in register 
when a WAIT macro instruction was 
issued, is greater than the number of 
ECBs being waited upon. 

102 An invalid ECB address has been given 
in a POST macro instruction. 

If a POST macro instruction has been 
issued by the problem program, the ECB 
address is given in register 1 of 
either the trace table entry or the 
SVRB for the ABEND routine. 

u 

If the POST was issued by ,an I/O 
interruption handler, the ECB address 
can be found in the IOB associated 
with the event. 

106 During a transient area load or a 

dynamic load resulting frojn a LINK, 
LOAD, XCTL, or ATTACH macro 
instruction, the fetch routine found 
an error,. A description of the error 
is contained in register 15 of ABEND* s 
SVRB register save area: 
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OD The control program found an 
invalid record type. 

OE The control program found an 
invalid address. The problem 
program may contain a relocatable 
expression that specifies a 
location outside the partition 
boundaries. 

OF A permanent I/O error has 

occurred. This error can probably 

be found in the trace table prior 
to the ABEND entry. 

Register 6 of ABEND* s SVRB register 
save area points to the work area used 
by the fetch routine. This area 
contains the IOB, channel program, RLD 
buffer, and the BLDL directory entry 
associated with the program being 
loaded. 

122 The operator cancelled the job and 
requested a dump. 

155 An unauthorized user (a user other 

than dynamic device reconfiguration) 
has issued SVC 85. The user's task 
has been abnormally terminated by 
dynamic device recognition. 

200 The error was detected when an I/O 
operation was requested and the 
storage protection keys of the IOB, 
ECB, and DCB were not the same as the 
key in the DEB. (checked for MVT 
only) 

201 This completion code is identical to 
102, but applies to the WAIT macro 
instruction instead of POST. 

202 An invalid RB address was found in an 
ECB. The RB address is placed in the 
ECB when a WAIT macro instruction is 
issued. 

213 The error occurred during execution of 
an OPEN macro instruction for a data 
set on a direct-access device. 
Either : 

1. The data set control block (DSCB) 
could not be found on the direct 
access device. 

2. An uncorrectable input/output 
error occurred in reading or 
writing the data set control 
block. 

Register 4 contains the address of a 
combined work and control block area. 
This address plus x*64' is the address 
of the data set name in the JFCBDSNM 
field of the job file control block 
( JFCB) . 



222 The operator cancelled the job without 
requesting a dump. The cancellation 
was probably the result of a wait 
state or loop. 

301 A WAIT macro instruction was issued, 
specifying an ECB which has not been 
posted complete from a previous event. 
Either: 

1. The ECB has been reinitialized by 
the problem program prior to a 
second WAIT on the same ECB, or 

2. The high order bit of the ECB has 
been inadvertently turned on. 

308 The problem program requested the 
loading of a module using an entry 
point given to the control program by 
an IDENTIFY macro instruction. 

Register of LOAD'S SVRB register 
save area contains the address (or its 
complement) of the name of the module 
being loaded. 

400 The control program found an invalid 

IOB, DCB, or DEB. Check the following 
blocks for the indicated information: 

• IOB - a valid DCB address. 
» DCB - a valid DEB address. 

• DEB - ID of OF and a valid UCB 
address. 

• UCB - a valid identification of 
FF. 

Note ; In systems with MVT, this code 
may appear instead of a 200 code, for 
the reasons given under 200. 

406 A program has the "only loadable" 

attribute or has an entry point given 
to the control program by an IDENTIFY 
macro instruction. In either case, 
the program was invoked by a LINK, 
XCTL, or ATTACH: macro instruction. 

Register 15 of the LINK, XCTL, or 
ATTACH SVRB register save area 
contains the address of the name of 
the program being loaded. 

506 The error occurred during execution of 
a LINK, XCTL, ATTACH, or LOAD macro 
instruction in an overlay program or 
in a program that was being tested 
using the TESTRAN interpreter. 

The program name can be found as 
follows: 

1. If a LOAD macro instruction was 
issued, register in the trace 
table SVC entry or in the SVRB 
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register save area contains the 
address (or its complement) of 
the program name. 

2. If a LINK, XCTL, or ATTACH was 
issued, register 15 of the 
associated SVRB register save 
area contains the address of a 
pointer to the program name. 



Note ; Programs written in an overlay 
structure or using TESTRAN should not 
reside in the SVC library. 

604 During execution of a GETMAIN macro 
instruction, the control program found 
one of the following: 

1. A free area exceeds the 
boundaries of the main storage 
assigned to the task. This can 
result from a modified FQE. 

2. The A-operand of the macro 
instruction specified an address 
outside the main storage 
boundaries assigned to the task. 

605 During execution of a FREEMAIN macro 
instruction, the control program found 
that part of the area to be freed is 
outside the main storage boundaries 
assigned to the task, possibly 
resulting from a modified FQE. 

Item 1 under the 604 completion code 
is also applicable to 605. 

606 During execution of a LINK, XCTL, 
ATTACH, or LOAD macro instruction, a 
conditional GETMAIN request was not 
satisfied because of a lack of 
available main storage for a fetch 
routine work area. Consequently, the 
request was not satisfied. 

The name of the load module can be 
found as described under completion 
code 506. 



reflects a unit check in the CSW 
status. 

704 A GETMAIN macro instruction requested 
a list of areas to be allocated. This 
type of request is valid only for 
systems with MVT. 

The applicable SVC can be found in a 
trace table entry or in the PSW at 
entry to ABEND. 

705 Results from the same situations 
described under 704 for FREEMAIN macro 
instructions . 

706 During execution of a LINK, LOAD, 
XCTL, or ATTACH macro instruction, the 
requested load module was found to be 
not executable. 

The name of the module can be found as 
described under the completion code 
506. 



804 The error occurred during execution of 
a GETMAIN macro instruction with a 
mode operand of EU or VU. More main 
storage was requested than was 
available. 



806 The error occurred during execution of 
a LINK, XCTL, ATTACH, or LOAD macro 
instruction. 

An error was detected by the control 
program routing for the BLDL macro 
instruction. This routine is executed 
as a result of these macro 
instructions if the problem program 
names the requested program in an EP 
or EPLOC operand. The contents of 
register 15 indicate the nature of the 
error: 

X*04 f The requested program was 
not found in the indicated 
source. 



60A Results from the same situations 

described under 604 and 605 for R-form 
GETMAIN and FREEMAIN macro 
instructions. 

613 The error occurred during execution of 
an OPEN macro instruction for a data 
set on magnetic tape. An 
uncorrectable input/output error 
occurred in tape positioning or in 
label processing. 

700 A unit check resulted from an SIO 
issued to initiate a sense command. 

The defective device can be determined 
from the SIO trace table entry that 



X'OS* An uncorrectable 

input/ out put error occurred 
when the BLDL control 
program routine attempted to 
search the directory of the 
library indicated as 
containing the requested 
program. 

Register 12 contains the address of 
the BLDL list used by the routine. In 
systems with MFT this address plus 4 
is the location of the 8-byte name of 
the requested program that could not 
be loaded. In systems with MVT, 
registers 2 and 3 contain the name of 
the requested module. 
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80A The error occurred during execution of 
an R-form GETMAIN macro instruction. 
More main storage was requested than 
was available. 



905 The address of the area to be freed 
(given in a FREEMAIN macro 
instruction) is not a multiple of 
eight. The contents of register one 
in either the trace table entry or 
ABEND'S SVRB register save area 
reflect the invalid address. 



B05 



A displacement of nine bytes from the 
list address passed to GETMAIN in 
register 1 contains the subpool 
number. Register 1 can be found in 
either the SVC trace table entry or 
ABEND* s SVRB register save area. 



Results from the same situation 
described under BO 4 for FREEMAIN macro 
instructions . 



90A Results from the same situations 
described under 905 for R-form 
FREEMAIN macro instructions. 

A05 The error occurred during execution of 
a FREEMAIN macro instruction. The 
area to be freed overlaps an already 
existing free area. This error can 
occur if the address or the size of 
the area to be freed were incorrect or 
modified. 

The contents of registers and 1 in 
either the SVC trace table entry or 
ABEND'S SVRB register save area 
reflect the size and address. 

AOA Results from the same situations 
described under A05 for R-form of 
GETMAIN and FREEMAIN macro 
instructions. 

BO 4 This error occurred during execution 
of a GETMAIN macro instruction. A 
subpool number greater than 127 was 
specified. The problem program is 
restricted to using subpools 0-127. 
This error can occur if the subpool 
number was either incorrectly 
specified or modified. 



BOA Results from the same situations 

described under BO 4 and BO 5 for R-form 
of GETMAIN and FREEMAIN macro 
instructions. 

The subpool number can be found in the 
high order bytes of register in 
either the SVC trace table entry or 
ABEND'S SVRB register save area. 

B37 The error occurred at an end of 

volume. The control program found 
that all space on the currently 
mounted volumes was allocated, that 
more space was required,, and that no 
volume was available for demounting. 

Either allocate more devices or change 
the program so that a device will be 
free when a volume must be mounted. 

Fnn An SVC instruction contained an 

invalid operand; nn is the hexadecimal 
value of the SVC. 

This error can occur if either an 
invalid instruction was issued by the 
problem program or an operand 
referring to an optional function was 
not included during system generation. 
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Appendix D: System Module Name Prefixes 



All load modules associated with a specific operating system component 
have a common prefix on their module names. This appendix lists the 
module name prefixes and the associated system component (s) - 



Prefix 



Component 



Prefix Component 



IBC 



Independent utility programs 



IFF 



Graphic programming support 



IEA supervisor, I/O supervisor, and 
NIP 

IEB Data set utility programs 

IEC Input/output supervisor 

IEE Master scheduler 

IEF Job scheduler 

IEG TESTRAN 

IEH System utility programs 

IEI Assembler program during system 
generation 

IEJ FORTRAN IV E compiler 

IEK FORTRAN IV H compiler 

IEM PL/I F compiler 

IEP COBOL E compiler 

IEQ COBOL F compiler 

IER Sort/Merge program 

IES Report program generator 

IET Assembler E 

IEU Assembler F 

IEW Linkage editor/overlay 

supervisor/program fetch 

IEX ALGOL compiler 

IEY FORTRAN IV G compiler 

IEZ System Interfaces 

IFB Environment recording routines 

IFC Environment recording and print 
routines 

IFD Online test executive program 



IFG Close, open, and related routines 

IGC Transient SVC routines 

IGE I/O error routines 

IGF Machine check handler program 

IHA System control blocks 

IHB Assembler during expansion of 
supervisor and data management 
macro instructions 

IHC FORTRAN library subroutines 

IHD COBOL library subroutines 

IHE PL/I library subroutines 

IHF PL/I library subroutines 

IHG Update analysis program 

IHI Object program originally coded in 
ALGOL language 

IHJ Checkpoint/ rest art 

IHL Generalized Trace Facility 

IHK Remote job entry 

UN 7094 emulator program for the 
Model 85 

IIO 7074 emulator program on the 
Models 155 and 165 

IIP 7080 emulator program on the Model 
165 

IIQ 1401/1440/1460 emulator program on 
Models 135,, 145, and 155 

IIR 1440/7010 emulator program on 
Models 145 and 155 

IIT 709/7090/7094/7094 II emulator 
program on the Model 165 
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Appendix E: List of Abbreviations 



ABEND abnormal end- of -task 

APR alternate path retry 

CCW channel command word 

CDE contents directory entry 

CPU central processing unit 

CSW channel status word 

CVT communications vector table 

DAR damage assessment routine 

DCB data control block 

DD data definition 

DDR dynamic device reconfiguration 

DEB data extent block 

DPQE dummy partition queue element 

DQE descriptor queue element 

ECB event control block 

FBQE free block queue element 

PQE free queue element 

FRB finch request block 

GQE gotten subtask area queue element 

IOB input/output block 

IPL initial program loading 

IRB interrupt request block 

LLE load list element 

LPRB loaded program request block 

LRB loaded request block 



MFT multiprogramming with a fixed 
number of tasks 



MVT multiprogramming with a variable 
number of tasks 



NIP nucleus initialization program 

PIB partition information block 

PQE partition queue element 

PRB program request block 

PSA prefixed storage area 

PSW program status word 

QCB queue control block 

QEL queue element 

RB request block 

SCB STAE control block 

SIO start input/output 

SIRB supervisor interrupt request block 

SPQE subpool queue element 

SVC supervisor call 

SVRB supervisor request block 

SYSOUT system output 

TCB task control block 

TIOT task input/output table 

UCB unit control block 

WLE wait list element 

XCTL transfer control 

XL extent list 
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Appendix F: ECB Completion Codes 



r t 

Hexadecimal 
Code 



Meaning 



7F0 00000 | Channel program has terminated without error. (CSW contents can be 
useful. ) 

41000000 | Channel program has terminated with permanent error. (CSW contents can 
be useful. ) 

42000000 | Channel program has terminated because a direct access extent address 
has been violated. (CSW contents do not apply.) 

44000000 | Channel program has been intercepted because of permanent error 

associated with device end of previous request. You may reissue the 
intercepted request. (CSW contents do not apply. ) 

48000000 I Request element for channel program has been made available after it 
has been purged. (CSW contents do not apply. ) 

4F0 00000 j Error recovery routines have been entered because of direct access 

error but are unable to read home address of record 0. (CSW contents 
| do not apply.) 

j. 



Appendix F: ECB Completion Codes 223 



224 Programmer's Guide to Debugging (Release 21) 



Appendix G: UCB Sense Bytes 



BYTEO 



BYTE 1 



\. BIT 

DEVICE\^ 





1 


2 


3 


4 


5 


6 


7 


2400 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


WORD 

CNT 

ZERO 


DATA 

CNVTT 

CHK 


2311, 
2841 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


TRK 

CCND 

CHK 


SEEK 
CHK 


2301,2302 
2303,2314 
2319,2820 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 




INVAL 
ADDR 


2250 


CMD 
REJ 


SHOULD 

NOT 

OCCUR 


BUS 
OUT 


SHOULD 

NOT 

OCCUR 


DATA 
CHK 


SHOULD 

NOT 

OCCUR 


BUFFER 
RUN- 
NING 


SHOULD 

NOT 

OCCUR 


2280 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


ILLGL 
SEG 


2282 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


ILLGL 
SEGN 


1052, 
2150 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 
















CHK 






1285 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


NON 
RCVY 


KYBD 
CORR 


1287 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


NON 
RCVY 


KYBD 
CORR 


1288 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


NON 
RCVY 


SHOULD 

NOT 

OCCUR 


2495 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


SHOULD 

NOT 

OCCUR 


POSN 
CHK 


SHOULD 

NOT 

OCCUR 


2540, 
2021 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


« ' ..''"& 




3505, 
3525 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


NOT 
USED 


ABNOR- 
MAL 
FORMAT 
RESET 


PERMAN- 
ENT ERROR 
(BYPASS 
KEY 


3211 


CMD 

REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


BUFFER 
PARITY 
CHK 


LOAD 

CHK 


CH 9 


1403, 
1443 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


/TYPE 
/ BAR 


/type 

/ BAR 




CH 9 


1442,2596 
2501,2520 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN- 








2671, 
2822 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 






- • —■■:■. 


2260 


CMD 

REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


2701, 
2702 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


LOST 
DATA 


TIME 
OUT 


1419/1275 
PCU 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


NOT 
USED 


DATA 
CHK 


OVER- 
RUN 


AUTO 
SELECT 


NOT 
USED 


1419/1275 
SCU 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 
CHK 


NOT 
USED 


NOT 
USED 


LATE 
STKR 
SELECT 


AUTO 
SELECT 


OP 
AH 


3330 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 




3410/3411 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


WORD 

CNT 

ZERO 


DATA 

CNVTT 

CHK 


2305 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 










3420/3803 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


WORD 

CNT 

ZERO 


DATA 

CNVTT 

CHK 






1 


2 


3 


4 


5 


6 


7 


NOISE 


OO-NON-XSTTU 
01 -NOT READY 
10-RDYaNORWD 
11-RDY8RW0NG 


7 
TRK 


AT 

LOAD 

POINT 


WRT 
STATUS 


FILE 
PROT- 
ECT 


NOT 
CAP- 
ABLE 


DATA 

CHK 

FLD. 


TRK 

OVER- 
RUN 


END 

OF 

CYL 


IN- 
VALID 
SEQ 


NO 
REC 
FOUND 


FILE 
PROT 


MISSING 

ADR 

MRKR 


OVER- 
FLOW 
INL 


DATA 
CHK IN 
COUNT 


TRK 
OVER- 
RUN 


END 

OF 

CYL 


INVAL 
SEQ 


NO 
REC 
FOUND 


FILE 
PROT 


SERVICE 

OVER- 
RUN 


OVER- 
FLOW 
INL 


LIGHT 

PEN 

DETECT 


END 

ORDER 

SEQ 


MO* ^^^^^^^ 


READ 

COUNT 

CHK 


FILM 
LOW 


RECRDR 
FORCED 
GAP 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


2840 

OUTPUT 

CHK 


2840 

INPUT 

CHK 


GRAPH- 
IC CHK 


READ 

COUNT 

CHK 


FILM 
LOW 


RECRDR 
FORCED 
GAP 


FILM 

MOTION 

LIMIT 


SHOULD 

NOT 

OCCUR 


2840 

OUTPUT 

CHK 


2840 

INPUT 

CHK 


GRAPH- 
IC CHK 


1 '•■':■ ■ . : "\. "••'• '■';•' ;;v«* }'' rr!! ?''iZ: ! Jf'l^*S v :" i ' • r ' i! '>*—;"'?■ 


























TAPE 
MODE 


LATE 
STKR 
SELECT 


NO 

DOC 

FOUND 


SHOULD 

NOT 
OCCUR 


INVAL 
OP 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


END 

OF 

PAGE 


NO 

DOC 

FOUND 


SHOULD 

NOT 

OCCUR 


INVAL 
OP 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


jf . . -. I;"?: 1 ;-* &"" ■'-..>. 


HHhh^Mh iBllll 






HI^P'V 




numm 




•;•' ' - 


iiiiiiS§BB||i 

IJMMMlfflBnSflMi 




PERM- 
ANENT 
ERROR 


AUTO- 
MATIC 
RETRY 


MOTION 
MALFUNC- 
TION 


RETRY 
AFTER 
INT REQ 
COMPLETE 


■ ' T .-.. 


•: ft—-** • ' 


CMD 
RETRY 


PRINT 
CHK 


PRINT 

QUAL- 
ITY 


LINE 
POS 


FORMS 
CHK 


CMD 
SUP 


MECHAN- 
ICAL 
MOTION 


j§f»Sajj 

mi 




■"' . ; 




iiiiaiiii 




111 


:l -' '.■'■: 






IIIIIEIIIIilll 


■".-. ." 


"<•. • 


IlEllilll 




'i; 








• i. ; ; . 


lllilll 




■ ■ • . __L •• 'i-Ji-;.*---' 




Wmi 






^^^^^^^^^^^^^^M 


NOT 
USED 


NOT 
USED 


DOC 
UNDER 
READ 
HEAD 


AMT 
FIELD 
VALID 


PROCESS 
CNTRL 
FIELD 
VALID 


ACCT* 

FIELD 

VALID 


TRANSIT 

FIELD 

VALID 


SERIAL* 

FIELD 

VALID 
















PERM 
ERR 


INVLD 

TRK 

FORMAT 


END 
OF 

CYL 


STATE 

VAR 

PRES 


NO 
REC 

FOUND 


FILE 
PROT 


WRITE 
INHIBIT 


OPER- 
ATION 
INL 


NOISE 


TU 

STATUS 

A 


TU ■ 
STATUS ill||§ 
B llllllll 


AT 

LOAD 

POINT 


WRT 
STATUS 


FILE 
PROT- 
ECT 


NOT 
CAP- 
ABLE 


PERM 
ERR 


INVLD 

TRK 

FORMAT 


END 

OF 

CYL 




NO 




HHUHnpER- 




REC 
FOUND 


FILE 1111111 
PROT ||I|j||jl 


ATION 
INL 


NOISE 


TU 

STATUS 

A 


TU 

STATUS 

B 


7 

TRK 

TU 


LOAD 
POINT 


WRT 
STATUS 


FILE 
PROT- 
ECT 


NOT 
CAP- 
ABLE 
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BYTE 2 



BYTE 3 



\ BIT 
DEVIClN^ 





1 


2 


3 


4 


5 


6 


7 


2400 


BITS 0-7 INDICATE A TRACK IS IN ERROR 


6&7INDICATE 
NO ERROR OR 
MULTI-ERROR 


2311,2841 


UN- 
SAFE 


SERIAL- 

IZER 

CHK 


TAG 
LINE 
CHK 


ALU 
CHK 


UNSEL 
STATUS 


^^^^^^^^B^l 


2301,2302 
2303,2314 
2319,2820 


UN- 
SAFE 


SHIFT 

REG 

CHK 


SKEW 
FAIL 


CTR 
CHK 


COMP 
CHK 






2250 




BUFFER ADDRESS REGISTER 
BIT 15 | BIT 14 1 BIT 13 | BIT 12 | BIT 11 | BIT 10 | BIT 9 


2280 


BUFFER ADDRESS REGISTER 
BIT 15 1 BIT 14 1 BIT 13 | BIT 12 j BIT 11 | BIT 10 | BIT 9 


2282 


lilBIillll 


BIT 15 


BIT 14 


BUFFER A 
BIT 13 


DDRESS R 
BIT 12 


EGISTER 
BIT 11 


BIT 10 


BIT 9 


3211 


CARR 
FAILED 
TO 
MOVE 


CARR 

SEQ 

CHK 


CARR 
STOP 
CHK 


PLATEN 
FAILED 
TO ADV 


PLATEN 
FAILED 
TO 
RETRACT 


FORMS 
JAM 


RIBBON 
MO- 
TION 


TRAIN 
OVER- 
LOAD 


3330 


flllll 


cor- BBSl 

RECT- 

ABLE Ejiiil 


ENV 
DATA 
PRESENT 






2305 


BUF 

LOG 

FULL 


COR- 
RECT- 
ABLE 






3505,3525 


USED FOR DIAGNOSTIC PURPOSES ONLY 


3410/3411 


TRACK IN ERROR 


3420/3803 


TRACK IN ERROR 



2311,2841 



2301,2302 
2303,2314 
2319,2820 



3330 



3410/341 1 



3420/3803 



ECHO 
ERR 



RES 


READ 


WRITE 


DELAY 


SEQ 


SEQ 


SEQ 


TAPE 


CLOCK 


CLOCK 


CNTR 


IND 


IND 


IND 


UNIT 


ERR 


ERR 


ERR 


C 


B 


A 



SEQ 
IND 




SEQ 
IND 
1 



SEQ 
IND 
2 



SEQ 
IND 
3 



SEQ 
IND 

4 



SEQ 
IND 
5 



SEQ 
IND 
6 



SEQ 
IND 
7 



PHYSICAL DRIVE IDENTIFICATION 



TAPE 
UNIT 
POS 
CHK 



ALU 
HARD- 
WARE 
ERROR 



TAPE 

UNIT 
REJ 



REJ 

TAPE 

UNIT 



EOT 



TAPE 
INDI- 
CATE 



WRITE 

TGR 

VRC 



MICRO- 
PRGM 
DETECT 
ERROR 



DIAG 

TRK 
CHK 



LWR 
ERROR 



TAPE 
UNIT 
CHK 



TAPE 
UNIT 
CHK 



3330* 


RE- 
VERSE 


CYL 
HIGH 


DIFFER 
HIGH 


HEAD ADDR 


2305* 


CURRENT HEAD ADDR 


3410/341 r 




SHORT 

GAP 

MODE 


DUAL 
DEN- 
SITY 


ALTER- 
NATE 
DENSITY 


TU MODEL 


3420/3803 


7 TRK 


WRT 

CURRENT 

FAILURE 


DUAL 
DEN- 
SITY 


NRZI 

DEN- 
SITY 


TAPE UNIT MODEL DEFINED 






1 


2 


3 


4 


5 


6 


7 


R/W 
VRC 


LRCR 


SKEW 


CRC 


SKEW 

REQ 

VRC 


0-1600 
1-800 


BKWD 
STATUS 


COM- 
PARE 


READY 


ON 
LINE 


READ 
SAFETY 


WRITE 
SAFETY 


lllllill 


END 

OF 

CYL 




SEEK 
INCMPL 


LRC 
BIT0 


LRC 
BIT 1 


LRC 
BIT 2 


LRC 
BIT 3 










BUFFER ADDRESS REGISTER 
BIT 8 | BIT 7 | BIT 6 | BIT 5 | BIT 4 j BIT 3 | BIT 2 | BIT 1 


BUFFER ADDRESS REGISTER 
BIT 8 | BIT 7 | BIT 6 | BIT 5 | BIT 4 | BIT 3 | BIT 2 | BIT 1 


BIT 8 


BIT 7 


BIT 6 


SUFFER ADDRESS REGISTER 
BIT 5 BIT 4 BIT 3 


BIT 2 


BIT 1 


UCSB 
PARITY 


PLB 
PARITY 


FCB 
PARITY 


COIL 
PROT 
CHK 


HAM- 
MER 
FIRE 


FIELD 
ENG 


USCAR 
SYNC 
CHK 


SEP 

SYNC 

CHK 


RESTART COMMAND 


RESTART COMMAND 


USED FOR DIAGNOSTIC PURPOSES ONLY 


VRC 


MTE/ 
LRCR 


SKEW 


END 
DATA 
CHK/ 
CRCR 


ENV 
CHK 


1600 
BPI 
SET IN 
TU 


BKWD 




R/W 
VRC 


MTE/ 
LRCR 


SKEW 


END 
DATA 
CHK/ 
CRC 


VRC 
ENV 
CHK 


1600 
BPI 
SET IN 
TU 


BKWD 


C 

COM- 
PARE 



BYTE 5 



COMMAND IN PROGRESS WHEN OVERFLOW INCOMPLETE OCCURS 
OR 
ZERO 



COMMAND IN PROGRESS WHEN OVERFLOW INCOMPLETE OCCURS 
WRITE = X"05' OR 

READ=X'06' ZERO 



CYLINDER ADDRESS 



CYLINDER ADDRESS 



NEW 
SUB- 
SYSTEM 



NEW 
SUB- 
SYSTEM 



NEW 
SUB- 
SYSTEM 



NEW 
SUB- 
SYSTEM 



WRT 
TAPE 
MARK 
CHK 



WRT 
TAPE 
MARK 
CHK 



PE 
ID 
BURST 



PE 
ID 
BURST 



PARITY 
COM- 
PARE 



START 
READ 
CHK 



TACHO- 
METER 
CHK 



PARTIAL 
RECORD 



FALSE 

END 

MARK 



EXCESSIVE 
POST- 
AMPLE 
ORTM 



RPQ 



BYTE 7 



FORMAT OF REMAINING 
SENSE BYTES (8-23) 


ENCODED ERROR 
MESSAGE 


ENCODED ERROR MESSAGE 


LAMP 

FAILURE 

CHK 


TAPE BOT- 
TOM LEFT 
COLUMN 
CHK 


TAPE BOT- 
TOM RIGHT 
COLUMN 
CHK 


RESET 

KEY 


DATA 
SECURITY 
ERASE 
CHK 










LAMP 
FAILURE 


TAPE 
[BOTTOM 
LEFT 


TAPE 

BOTTOM 

RIGHT 


RESET 
KEY 


DATA 

SECURITY 

ERASE 


ERASE 

HEAD 


AIR 

BEARING 
PRES- 
SURE 


LOAD 

FAILURE 
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BYTE 8 



BYTE 9 



\. BIT 

deviceX^ 





1 


2 


3 


4 


5 


6 


7 


3410/3411 


••;■ ...V'""- 


THROUGH HH Ull VELOCITY 


NO 
READ- 
BACK 
DATA 


START 
VELO- 
CITY 
CHK 




MARG- 
INAL 
VELO- 
CITY 


3420/3803 


IBG 
DROP 
WHILE 
WRT 


^llf" 


EARLY 
END 
RDBK 
CHK 


SLOW 
BEGIN 
RDBK 
CHK 


SLOW 
END 
RDBK 
CHK 


VELO- 
CITY 
RETRY 



BYTE 10 



3420/3803 


STATUS 11 UNIT 


NO 

BLK ON 
RECORD 
RD BK 
CHK 


WTM 
NOT 

DETECT 


ifflN" 



BYTE 12 



3420/3803 


B2 BUS 
PARITY 
LSR ADDR 
ERR 


ROS2 

PARITY 
ERR 


XFR/ 
LOW 
IC2 
ERR 


INSTR 
DECODE 

4 


ALU 2 

MICRO- 

PRGM 

DETECT 

HRDWR 


y -^ 



BYTE 14 



3420/3803 



CONTROL UNIT 
UNIQUE ID LOW 



BYTE 16 



3420/3803 



TAPE UNIT 
UNIQUE ID 



3420/3803 


POWER 
CHK/ 
OVER- 
TEMPER- 
ATURE 




EC LEVEL OF TAPE UNIT 



BYTE 20 



3420/3803 



PRIMED FOR DEVICE END 
TU F I TU E I TU D I TU C I TU B I TU A I TU 9 I TU : 




SDR 
CNT 



VELOCITY 
CH6E 
WHILE 
WRTN6 



SDR CNTRS 






cu 



BYTE 1 1 



Bl BUS 
PAR/LSR 
ADDR 
ERR 



ROSI 
PAR 

ERR 



XFR/ 
LOW 
IC 1 
ERR 



INSTRU- 
CTION 
DECODE 



ALU I 

MICRO- 

PR6M 

DETECT 

HRDWR 




BYTE 13 



CONTROL UNIT 
DENSITY 



CONTROL UNIT 
UNIQUE ID HIGH 



BYTE 15 



TAPE UNIT 
UNIQUE ID 



BYTE 17 



TWO 
CHAN- 
NEL SW 
(MIS) 


CONTROL UNIT 

DEVICE 

SWITCH FEATURES 


EC LEVEL OF 
CONTROL UNIT 



BYTE 19 



TU7 



PRIMED FOR DEVICE END 



TU 6 I TU 5 I TU 4 I TU 3 TU 2 TU 1 



TU0 



BYTE 21 



LOAD 

BUTTON 

DEPRESS 


LEFT 
REEL 
TURN- 
ING 


RIGHT 
REEL 
TURN- 
ING 


TAPE 
PRE- 
SENT 


REELS 
LOADED 


LOAD 
REWIND 


LOAD 
COM- 
PLETE 


LOAD 
CHECK 



BYTE 22 



3420/3803 



FRU IDENTIFIERS FOR CONTROL UNIT 



FRU IDENTIFIERS FOR CONTROL UNIT 
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Appendix H: Service Aids 



In addition to the debugging facilities discussed in this manual, IBM 
provides the following service aid programs to aid you in debugging. A 
complete description of each of these service aids and instructions for 
their use are found in the publication IBM System/360 Operating System 
Service Aids ,. GC28-6719. 



Program Name 



Functional Description 



IMDSADMP A stand-alone program, assembled with user-selected 

options, that dumps the contents of main storage onto a 
tape or a printer- The program has two versions: 

• A high speed version that dumps the contents of main 
storage to a tape. 

• A low speed version that formats and dumps the 
contents of main storage either to a tape or directly 
to a printer. 

IMDPRDMP A problem program that allows the user to format and print 
IMSADMP output data sets, the SYS1.DUMP data set, the TSO 
dump data set and its associated swap data sets, and 
Generalized Trace Facility output data sets. IMDPRDMP can 
also be used to transfer a system dump from a SYS1.DUMP 
data set on a direct access device to another data set for 
later formatting and printing. 

IMCJQDMP A stand-alone program that reads, formats, and prints 

either the entire operating system data set SYSl.SYSJOBQE, 
or selects and prints information related to a specific 
job in that data set. Because it operates independently 
of the operating system, IMCJQDMP can print the contents 
of the job queue as it appeared at the time of abnormal 
termination. 



IMCOSJQD A problem program that reads,, formats, and prints the 

contents of the system job queue data set (SYSl.SYSJOBQE). 
Either the entire job queue or information related to a 
specific job may be printed. 

Because the program can be run under OS, it is not 
necessary to re-IPL the operating system as with IMCJQDMP. 



IMBLIST A problem program that produces formatted listings of 
object modules, load modules, module cross references, 
CSECT identification records (IDRs) , and PTFs. 

IMBMDMAP A problem program that produces a map of the system 

nucleus, any load module, the resident reenterable load 
module area of an MFT system, or the link pack area of an 
MVT system. The listing produced by this program shows 
the locations of CSECTS, external references, and entry 
points within a load module. 



IMASPZAP A problem program that can inspect and modify either data 
records or load modules located on a direct access storage 
device. 
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IMAPTFLE 



IFCDIPOO 



IFCEREPO 



A problem program that generates job control language 
(JCL) statements necessary to add a PTF to the Operating 
System in a later step, or applies PTFs to the Operating 
System by dynamically invoking the linkage editor. 

A problem program that initializes the SYS1.LOGREC data 
set. 



A problem program that edits, writes, and accumulates 
environment records on the SYS1.LOGREC data set. 
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Appendix J: TCAM Debugging Aids 



In addition to the debugging facilities described in this publication, 
the telecommunications access method provides the following aids to 
debugging : 

• I/O error recording procedures. 

• I/O interrupt trace table (line trace). 

• A dispatcher subtask trace table (STCB trace). 

• Sequential listings of buffers and message queue data sets. 

Optional formatted listings of the line and STCB traces are available 
with TCAM. These debugging aids are described in the publications IBM 
System/360 Operating System; TCAM Programmer's Guide and Reference 
Manual , GC30-2024, and IBM System/360 Operating System: TCAM 
Serviceability Aids Program Logic Manual , GY30-2027. A discussion of 
the TCAM formatted ABEND dump is given in the publication IBM System/360 
Operating System: TCAM Program Logic Manual , GY30-2029. 
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Appendix K: Control Block Pointers 



This appendix summarizes the contents of the control blocks that are 
most useful in debugging. Control blocks are presented in alphabetical 
order, with displacements in decimal, followed by the hexadecimal 
counterpart in parentheses. Figure 56 illustrates control block 
relationships in the System/360 Operating System. Figure 57 shows 
relationships between storage control elements in a system with MVT. 



CVT - Communications Vector Table 
+0 Address of TCB control words 
+53(35) Address of entry point of ABTERM 
+193 (CI) Address of secondary CVT (used 

only with Model 65 

Multiprocessing systems and TSO) 



RB - Request Block (MVT) 

+4 Last half of user's PSW 

+13 (D) CDE address 

+16(10) Resume PSW 

+29 (ID) Address of previous RB 



DCB - Data Control Block 

+40(28) ddname (before open); offset to 

ddname in TIOT (after open) 
+45 (2D) DEB address 
+69(45) IOB address 



DEB - Data Extent Block 

+1 TCB address 

+5 Address of next DEB 

+25(19) DCB address 

+33(21) UCB address 

+38(26) Address of start of extent 

+42 (2A) Address of end of extent 



TIOT - Task Input/Output Table 

+0 Job name 

+8 Step name 

+24(18) DD entries begin (one variable- 
length entry for each DD 
statement) 

+0 Length of DD entry 

+4 ddname 

+16(10) Device entries begin (one 4-byte 
entry for each device) 

+20(14) Next device entry (if there is 
one) 



(Next DD entry begins at 24(18) 
plus length of first DD entry) 



ECB - Event Control Block 

+1 RB address or completion code 



IOB - Input/Output Block 



-7 

+2 
+5 

+9 

+17(11) 

+21(15) 



Address of next IOB (BSAM, 
and BPAM) 
Sense bytes 
ECB address 

CSW 

CCW list address 

DCB address 



QSAM, 



RB - Request Block (PCP and MFT) 

-8 Address of previous RB on load 

list 
-4 Address of next RB on load list 
+0 Module name 
+13 (D) Entry point address 
+16(10) Resume PSW 
+29 (ID) Address of previous RB 



TCB - Task Control Block (PCP and MFT) 

+1 Address of most recent RB 

+9 Address of most recent DEB 

+13 (D) TIOT address 

+16(10) Completion code 

+25(19) MSS boundary box address 

+37(25) Address of most recent RB on load 

list 
+113(71) Address of first save area 
+161 (Al) Address of STAE control block 
+181 (B5) Address of the job step control 

block 



TCB - Task Control Block 

(MFT) with Subtaskinq 

+45 (2D) Address of TCB for job step task 

+129 (81) Address of TCB for next subtask 

attached by same parent task 
+133(85) Address of TCB for parent task 
+137(89) Address of TCB for most recent 

subtask 
+145(91) Address of ECB to be posted at 

task completion 
+181 (B5) Address of the job step control 

block 
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TCB - Task Control Block (MVT) 

+1 Address of most recent RB 

+9 Address of most recent DEB 

+13 (D) TIOT address 

+16(10) Completion code 

+25(19) Address of most recent SPQE 

+33(21) Bit 7 — Non-dispatchability bit 

+37(25) Address of most recent LIE 

+113(71) Address of first save area 

+125 (7D) Address of TCB for job step task 

+129(81) Address of TCB for next subtask 

attached by same parent task 
+133(85) Address of TCB for parent task 
+137(89) Address of TCB for most recent 

subtask 
+145(91) Address of ECB to be posted at 

task completion 
+153(99) Address of dummy PQE minus 8 

bytes 
+161 (Al) Address of STAE control block 



+181 (B5) Address of the job step control 
block 



UCB - Unit Control Block 

-4 CPU ID (used only with Model 65 

Multiprocessing systems) 
+2 FF (UCB identification) 
+4 Device address 
+13 (D) Unit name 
+18(12) Device class 
+19(13) Device type 
+22(16) Sense bytes (except devices with 

extended sense) 
+24(18) Number of sense bytes (devices 

with extended sense) 
+25(19) Address of sense bytes (devices 

with extended sense) 
+40(28) Number of outstanding RESERVE 

requests (shared DASD only) 



234 Programmer's Guide to Debugging (Release 21) 





\ 


\ \\ \ 


TT^ 


8 

0| 




Direct 
access 
address 








CO 
LU 

Q 




_>< 

dl 

CO 

o 








O tt 
i= O 










\ 










\ 


* 



\ 

\ 


C 
D 

o 
O 




O 


p 
o 
Q 


a) 
■o 

o 
U 





Figure 56. Control Block Flow 
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Appendix L: OPEN/CLOSE/EOV Debugging Aids 



There are two types of traces that may be 
performed during OPEN/CLOSE/EOV processing, 
provided that GTF is active, 

• ABEND trace - A trace performed before 
an OPEN/CLOSE/EOV problem determination 
module calls an ABEND routine. 

• Optional work area trace - A trace 
performed when an OPEN/CLOSE/EOV module 
has finished execution. This trace is 
made only if DCB=DIAGNS=TRACE is 
specified in the DD statement of the 
data set for which the trace is 
desired. 

Further information on requesting these 
traces is contained in IBM System/360 
Operating System: Data Management 
Services . GC26-3746. 



The format of both types of 
OPEN/CLOSE/EOV trace output is as follows: 



r —i 

|USRFF FFF ccc control block fields j 

i j 



USRFF 



is the name (excluding the IMD prefix) 
of the IMDPRDMP appendage which 
formats the control block and work 
area information collected by 
OPEN/CLOSE/EOV and included in the GTF 
output data set. FF is the format ID 
for OPEN/CLOSE/EOV. 



FFF 



ccc 



is the event ID which defines the 
event which caused the trace entry- 
Everything traced by OPEN/CLOSE/EOV 
has an event ID of FF. 



is the control block that was traced 
to provide the problem program with 
OPEN/CLOSE/EOV data for debugging 
purposes. 

When the OPEN/CLOSE/EOV ABEND trace 
occurs, only those control blocks 
meaningful to an ABEND condition will 
be traced. The selection of these 
control blocks is described in IBM 
System/360 Input/Output Support 
(OPEN/CLOSE/EOV) PLM . GY28-6609. 

If the optional work area trace has 
been requested, the OPEN/CLOSE/EOV 
work area and the user's DCB will be 
traced after the execution of each 
OPEN/CLOSE/EOV module. 

control block fields 

are the contents of fields in control 
block ccc. For descriptions of the 
fields shown, refer to IBM System/360 
Operating System: system Control 
Blocks . GC28-6628 or IBM System/360 
Operating System: Input/Output 
Support (OPEN/CLOSE/EOV) PLM . 
GY28-6609. 
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Index 



Indexes to systems reference library 
manuals are consolidated in the publication 
IBM System/360 Operating System: Systems 
Reference Library Master Index . GC28-6644. 
For additional information about any 
subject listed below, refer to other 
publications listed for the same subject in 
the Master Index. 

When more than one page reference is 
given, the major reference is first. 



ABEND dumps 

contents of (MVT) 46-64 

contents of (MFT) 29-45 

guide to using (MVT) 63-64 

guide to using (MFT) 44-45 

how to invoke (MVT) 46 

how to invoke (MFT) 29 

introduction to 11 

samples of (MVT) 47-48 

samples of (MFT) 30-31 
Abnormal termination, cause of 

in an ABEND/SNAP dump (MVT) 63 

in an ABEND/SNAP dump (MFT) 44 
Abnormal termination dumps (see ABEND 

dumps) 
Active RB queue 

description of 16 

instructions for using 205 

in a storage dump 141 

in an ABEND/SNAP dump (MVT) 52,63 

in an ABEND/SNAP dump (MFT) 37,44 

in an indicative dump 67 
AMWP bits 

in an indicative dump 67 

meaning of 206 
APSW field, in an ABEND/SNAP dump 

(MVT) 52,63 
ATTACH macro instruction, effects of 18 
Attaching subtasks 20 

Boundary 

problem program 40,206 

Catalog dump 32 
CDE 

as used with the load list 17 

format of 25 

in an ABEND/ SNAP dump 54 

in a storage dump 141 
Communications vector table (see CVT) 
Complete dump (MVT) 

description of 46 

sample of 47,48 
Completion codes 

description of common 215 

explanation of 205 

in an ABEND/SNAP dump (MVT) 49 

in an ABEND/SNAP dump (MFT) 35 

in an indicative dump 67 



| Console dump facility 68 
COND parameter, 

to regulate job step execution 32 
Contents directory 

description of 17,25 

entries (see CDE) 
Control blocks 

descriptions of 26,27 

pointers in 231 

relationships between 27 

use in debugging 205 
Control block displays (IMDPRDMP output) 
74-122 

MFT DEB format 103 

MFT job pack queue format 102 

MFT load list format 102 

MFT problem program boundaries 101-102 

MFT RB format 98 

MFT TCB format 92-98 

MFT TIOT format 107 

MVT DEB format 87-90 

MVT job pack queue format 86-87 

MVT load list format 86 

MVT main storage information 85 

MVT RB format 81-85 

MVT TCB format 75-80 

MVT TIOT format 90-92 

TSO PSCB format 121 

TSO RCB format 113 

TSO SWAP DCB format 116 

TSO TAXE format 123 

TSO TJB format 116 

TSO TJBX format 120-121 

TSO TSB format 118 

TSO TSCVT format 108 

TSO UMSM format 116 
Control information 13 
Control program nucleus 

ABEND/SNAP (MVT) 60 

ABEND/SNAP (MFT) 43-44 
CVT 

description of 26 

in a storage image dump 138,139 

pointers in 231 

Data control block (see DCB) 

Data event control block 27 

Data extent block (see DEB) 

Damage assessment routine (DAR) 68 

DCB 

description of 27 

in a storage dump 144 

pointers in 231 
DD statements 

required with ABEND/SNAP dumps 29,32 

sample of SYS ABEND 32 
DEB 

description of 27 

in a storage dump 143 

in an ABEND/SNAP dump (MVT) 55 

in an ABEND/SNAP dump (MFT) 41 

pointers in 231 
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DEB queue 

in a storage dump 143 

in an ABEND/SNAP dump (MVT) 50 

in an ANDED/SNAP dump (MFT) 35 
Debugging procedure 

description of 205 

summary 207 
DELETE macro instruction 16 
Dequeued elements 34 
Descriptor queue element (see DQE) 
Destroyed queues 32 
Device considerations, 

for ABEND/ SNAP dumps 29,32 
Dispatcher trace table entry (MVT) 

format of 148,149 

in a SNAP dump 61, 64 

in a storage image dump 146 
Dispatching priority 19,20 
DQE 

format of 24 

in a storage dump 143 

in an ABEND/SNAP dump 56,64 
Dump (see individual type of dump, e.g., 

ABEND, indicative) 
Dump data set 

MVT 46 

MFT 29 
I Dump list heading (IMDPRDMP output) 70 
Dynamic area 

in systems with MVT 20 

in systems with MFT 19 



ECB 

completion codes, list of 223 

description of 27 

in a storage dump 145 

pointers in 231 

posting of, using ATTACH 18 
Event control block (see ECB) 
Extent list (see XL) 
External interruption 206 
External trace table entry 

format of 148 

in a SNAP dump 61,63,64 

in a storage dump 14 8,14 9 



FBQE 

format of 22-23 

in a storage dump 14 6 

in an ABEND/SNAP dump 57,64 
FINCH request block 14 
Finding the partition TCB 141 
FRB 14 
Fixed area 

in systems with MFT 19 

in systems with MVT 20 
FQE 

format of (MFT) 21 

format of (MVT) 24 
Free areas 

in an ABEND/SNAP dump (MFT) 44 
Free block queue element (see FBQE) 
Free queue element (see FQE) 



General debugging procedure 
description of 205-207 
summary 207 
General format (IMDPRDMP output) 128 
Generalized trace faility (GTF) 150-203 
comprehensive trace records 
158-166,169-202 
DSP 162 
EXT 163 
10 159 
PCI/IO 159 
PGM 165 
SIO 161 
SSM 166 
SVC 170 
description of 15 
hexadecimal format record 168 
lost event record 167 
minimal trace records 150-157 
DSP 153 
EXT 154 
IO 151 
PCI/IO 151 
PGM 155 
SIO 152 
SSM 157 
SVC 156 
SVC comprehensive trace records 169-202 

sub -index 169 
time record 167 
GETMAIN macro instruction 21-22 
Gotten subtask area queue element 21-22 
GQE 21-22 

GTF (see Generalized Trace Facility) 
GTF trace table 

in ABEND/SNAP dumps 150 
in IMDPRDMP output 150 
Guide to using storage image dump 137 



Hardware error 205,206 
Hierarchy, main storage 



20-22 



IFCDIP00 230 
IFCEREP0 230 
IMAPTFLE 230 
IMASPZAP 229 
IMBLIST 229 
IMBMDMAP 229 
IMCJQDMP 229 
IMCOSJQD 229 
IMDPRDMP 229 
IMDSADMP 229 
Indicative dumps 

contents of 65-67 

description of 65 

guide to using 67 

introduction 11 
Input/output block (see IOB) 
Interrupt request block 14 
Interruptions 205,206 
IOB 

description of 27 

in a storage dump 144-145 

pointers in 231 
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I/O trace table entry 
format of 148 

in a storage dump (MFT) 148-149 
in a storage dump (MVT) 148 
in a SNAP dump (MVT) 61,63-64 
in an ABEND/ SNAP dump (MFT) 42,44 

IRB 14 



Job pack area 14, 17 
Job pack area queue 17 
Job step 19 

Job step task (MVT) 20,46 
JPAQ 17 



LINK macro instruction, effects of 18 

Link pack area (MVT) 20-21 

Link pack area maps (IMDPRDMP output) 

71-73 
LLE 

count field 17 

description of 17 

in an ABEND/SNAP dump (MVT) 50 
Load list 

description of 16 

instruction for using 205,207 

in a storage dump 142 

in an ABEND/SNAP dump (MVT) 53,63 

in an ABEND/ SNAP dump (MFT) 38,44 

in an indicative dump 66 

in systems with MVT 17 

in systems with MFT 16-17 
Load list element (see LLE) 
LOAD macro instruction, effects of 18-19 
Load module, storage control for 

in an ABEND/SNAP dump (MVT) 53-54,64 

in systems with MVT 25-26 
Loaded program request block 14 
LPRB 14 
LRB 14 



Main storage hierarchy support 
inclusion of 20-22 
effects on MSS boundary box 21 
effects on partition queue 21 
Main storage layout 

in systems with MFT with subtasking 

19-20 
in systems with MFT without subtasking 

19 
in the systems with MVT 20 
Main storage supervisor's boundary box 

(see MSS) 
Machine check interruption 205-207 
MFT, systems with 

considerations in using an ABEND/SNAP 

dump of 44-45 
contents of an ABEND/SNAP dump of 34-45 
guide to using a storage 

dump of 137 
how to invoke an ABEND/ SNAP 

dump of 29 
main storage layout in 20 
storage control in 21-23 
task control characteristics of 19-20 
trace table entries in 148 



Model 65 Multiprocessing system 

trace table formats 149 

prefixed storage area, as shown in an 
ABEND/SNAP dump (MVT) 60 

trace table entries in a SNAP dump 62 
Module name prefixes, list of 219 

description of (MFT) 21-22 

in an ABEND/SNAP dump (MVT) 55-56 

starting address (MFT) 35 
Multiprogramming with a fixed number of 

tasks (see MFT, systems with) 
Multiprogramming with a variable number of 

tasks (see MVT, system with) 
MVT, systems with 

complete ABEND/SNAP dump of 47-48 

contents of an ABEND/ SNAP dump 46-64 

guide to using a storage image dump of 
137-146 

guide to using an ABEND/ SNAP dump 
of 63-64 

how to invoke an ABEND/ SNAP dump of 46 

load list 16 

main storage layout in 20 

storage control in 22-26 

task control characteristics in 20 

trace table entries in 148 



Nucleus 

contents of 19-20 

in an ABEND/SNAP dump (MVT) 

in an ABEND/SNAP dump (MFT) 



60 
44 



Only loadable (OL) 14 
OPEN/CLOSE/EOV debugging 241 
Output comments (IMDPRDMP output) 

from GTF processing 203 
Overlaid problem program 34 



130-136 



Partition (MFT) 19-20 

Partition queue element (see PQE) 

Partition TCBs 138-141 

PIE 35,49 

Pointers, control block 231 

PQE 

format of 23 

in a storage dump 143 

in an ABEND/SNAP dump 56-6 4 
PRB 14 

Priority 19-20 
Problem program, how to locate in a 

dump 205-207 
Problem program storage boundaries, in an 

ABEND/SNAP dump (MFT) 40 
Program check interruption 205,206 
Program check old PSW 

in an ABEND/SNAP dump (MVT) 52, 63 

information in 205,206 
Program check trace table entry 

format of 148 

in a SNAP dump 61-62 

in a storage dump 145-146 
Program interruption element (see PIE) 
Program request block 14 
Protection key 35 
PSCB 146 
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PSW at entry to ABEND 

in an ABEND/SNAP dump (MVT) 49 
in an ABEND/SNAP dump nMFT) 35 

PSW, program check old (see program check 
old PSW) 

PSW, resume (see resume PSW) 

QCB 57 

Queue control block trace (IJMDPRDMP 

output) 70-71 
Queue elements (MVT) 21,22-26 
Queues destroyed 34 



RB 

as affected by LINK, ATTACH, XCTL and 
LOAD 18 

formats of 13-16 

in an ABEND/SNAP dump (MVT) 52-54 

in an ABEND/SNAP dump (MFT) 37,3 8,44 

in an indicative dump 66 

most recent 35, 49 

name field, in a dump 205 

purpose of 13 

pointers in 231 

pointers to, in a storage dump 141-142 

queue (see active RB queue) 

sizes of 15 

types of 13-14 

when created 13 

which ones appear in a dump 205 
RCB 145 
Re-creating the task structure 

MFT with subtasking 139 

MVT 139 
Reenterable load module area (MFT) 19 
Region (MVT) 

contents of, in an ABEND/SNAP dump 64 

description of 20 

storage control for 22-24 
Register contents 

in a save area 147 

in an ABEND/SNAP dump (MVT) 60-61 

in an ABEND/ SNAP dump (MFT) 43 

in an indicative dump 66 
Request block (see RB) 
Resume PSW 

in an ABEND/ SNAP dump (MVT) 53,62 

in an ABEND/SNAP dump (MFT) 38,44 

in an indicative dump 67 
Retain dump 32 
Rollout/rollin 

effects on partition queue 22-23 



Save areas 

format of 147 

in an ABEND/SNAP dump (MVT) 58 

in an ABEND/SNAP dump (MFT) 40 
Save area chain 147 
Sense bytes, UCB 

table of 225 
Sequential partitioned system (see MFT, 

systems with) 
Service aids 229 
Set system mask trace table entry 

format of 149 

in an ABEND/SNAP dump 62 



SIO trace table entry 

format of (MFT) 148 

format of (MVT) 148 

in a SNAP dump (MVT) 62-63 

in an ABEND-SNAP dump 
(MFT) 42,44-45 
SIRB 14 
SNAP dumps 

contents of (MVT) 46-63 

contents of (MFT) 32-44 

guide to using (MVT) 63-64 

guide to using (MFT) 44-45 

how to invoke (MVT) 46 

how to invoke 5MFT) 29 

introduction to 11 
Snapshot dumps (see SNAP dumps) 
Space considerations, for ABEND/SNAP 

dumps 32 
SPQE 

format of 24 

in a storage dump 143 

in an ABEND/SNAP dump 55,64 
SQS (see system queue space) 
SSM (see set system \mask trace table entry) 
Storage control 

in systems with MFT with subtasking 22 

in systems with MFT without subtasking 
21 

in systems with MVT 25,26 
Storage dumps 

discussion of 68 

guide to using 137 

introduction to 11 
Subpool 

definition of 24 

in a storage dump 143 

in an ABEND/SNAP dump 55,64 

queue elements (see SPQE) 
Subtask, as created by ATTACH 18 
Supervisor calls, list of 209 
Supervisor interrupt request block 14 
Supervisor request block 14 
SVC trace table entries 

format of (MFT) 148 

format of (MVT) 148 

in a SNAP dump (MVT) 61-62 

in an ABEND/SNAP dump (MFT) 42-44 
SVCs, list of 209 
SVRB 14 
SYSABEND DD statement 

description of 32 

samples of 33 
SYSOUT, as a dump data set 32 
System control blocks (see control blocks) 
System differences in task control 18-20 
System failure 68 
System queue space (MVT) 20 
System tasks 18-20 
System wait TCB 75 
SYS1.DUMP data set 68,29 
SYSUDUMP DD statement 29 



Task completion code (see completion codes) 

Task control block (see TCB) 

Task control differences, by system 18-20 

Task dispatching priority 20 

Task input/output table (see TIOT) 
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Task management 13-21 

Task supervision 13-21 

Task structure, recreating the, using a 

storage dump (MVT) 139 
Task switch trace table entry (MFT) 

format of 148 

in an ABEND/ SNAP dump 44 
Task switching (MFT) 20 
TAXE 146 

TCAM Debugging Aids 231 
TCB 

description of 13 

in an ABEND/SNAP dump (MVT) 49-51 

in an ABEND/ SNAP dump (MFT) 35-37 

information available through 13 

locating, in a storage dump 138-141 

pointers in 231 

pointers to, in a storage dump (MFT) 
138-139 

queue (MFT) 19,20 

queue (MVT) 20 

relationships 19-20 

summary display (IMDPRDMP output) 
124-127 

MFT without sub task TCBs 125 

MFT or MVT with subtask TCBs 125 
TCBLCT 20,233 
TCBNTC 20,233 
TCBOTC 20,233 
TCBTCB 20,233 

Telecommunications Access Method (see TCAM) 
Termination, abnormal (see abnormal 

ter minat i on ) 
TIOT 

description 26 

in ABEND dump (MVT) 55 

in IMDPRDMP output (MVT) 90 

pointers in 233 



42 



TJB 146 
TJBX 146 
Traces 147-150 
Trace table 

control block 148 

delimiting entries, in an ABEND/SNAP 
dump (MFT) 44 

description of 148 

format of entries (MFT) 148 

format of entries (MVT) 149 

format of entries 
(Mod 65 multiprocessing systems) 149 

in a SNAP dump (MVT) 61-62 

in a storage dump 14 8-149 

in an ABEND/SNAP dump (MFT) 

samples of entries 148-149 

usefulness in debugging 206 
TSB 146 
TSCVT 145 
TSO Control Blocks 145-146 



UCB 

description of 27 

in a storage dump 144 

in an ABEND/SNAP dump (MFT) 

pointers in 234 

UMSM 146 

Unit control block (see UCB) 

Use count 17 



41 



Wait list 17 
Wait list element 
WLE 17 



17,18 



XCTL macro instruction, effects of 
XL 

description of 25 

in a ABEND/SNAP dumps 54,64 



18 
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Note ; Please direct any requests for copies of publications, or for assistance in using your 
IBM system, to your IBM representative or to the IBM branch office serving your locality. 
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